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INDEX TO SUBJECTS 


The following two lists are all for the currently defined Tech Note 
catagories. This index can be used to refer to the proper section of Tech 
Notes to find an answer. For example, a question about Apple /// Emulation 
Mode would be answered in section l699. 
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1700 Apple /// Interfacing 
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2599 Apple Writer 

2559 Apple Writer /// 

2243 Apple Writer j[ 

2699 Applesoft 

2799 Applesoft Firmware Card 
2800 Artist Designer 

299% Auto-Start ROM 

3000 Bridge Tutor 

9399 Bulletin Board Systens 
31809 Business Basic 

3139 Business Graphics /// 
3169 Business Graphics ][ 

3200 Centronics Printer Interface 
3300 Communications Interface 
3709 DOS 

3809 DOS Tool Kit 

4109 Elementary, My Dear Apple 
4200 Formulex 

430p FORTRAN 

1899 General Information 
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INTERFACING TO RS-232 PRINTERS 


The Table 1 and Table 2 on the following pages give the cable adapter 

wiring diagrams for some popular printers. Scan Table 1 until you find the 
brand and model of your printer. The number in the "DIAGRAM column 
indicates which wiring diagram from Table 2 you need. The "NOTES" column in 
Table 1 gives additional information for proper interfacing. Wire up the 
adapter as shown and install it between the Apple and the printer. 


In all cases be sure that the baud, parity, word length, etc. are set to 
the same value on both the printer and the Apple interface. 


Included below is the specification for Apple^s RS-232 interfaces in 
case your printer isn't mentioned. 


Pin Name Function Notes 

L GND Frame ground 

2 TxD Transmit Data Data output to printer 

3 RxD Receive Data Not used by printer driver 

4 -RTS Request To Send Handshake output to printer 
5 SCIS Clear To Send Do not use 

6 -DSR Data Set Ready Handshake input from printer 
7 GND Signal ground 

8 -DCD Data Carrier Detect Handshake input from printer 
29 -DTR Data Terminal Ready Handshake output to printer 

The "-" before the name of a signal indicates that it is a negative true 


signal. These signals are considered active if the signal is above +3 
volts at the RS-232 connector and inactive if less than -3 volts. 


Use of -CTS is discouraged because it directly controls the Apple's data 
transmitter and may stop transmission in the middle of a character. The 
Apple /// printer driver sets up -RTS and -DTR to alert the printer and 
checks both -DSR and -DCD for printer ready information before transmitting 
any characters. All handshake input lines are pulled to an enabled 
condition on the Apple /// if the printer doesn't use them. 
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TABLE 1 


PRINTER 


ANADEX DP-9560$ 


DP-9541 
ANDERSON JACOBSON 832 
833 
341 
AXIOM EX-891 
EX-829 


CENTRONICS 737 


C-ITOH 
C-ITOH F1 


COMPRINT 912 
DATA ROYAL 5999 


DEC LA34 
LAL 29 


DIABLO 629 
DIABLO 636 


EPSON MX-7$ 
MX-86 
MX-199 


HEATHKIT H-14 


IDS 125 
225 
449 
445 
469 
560 


NEC 5519 / 7719 
5515 / 7715 
5529 / 7729 


5325 3 7125 
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DIAGRAM NOTES 

5 CHECK PARITY, BAUD, STOP BITS, ETC 
5 CHECK PARITY, BAUD, STOP BITS, ETC 
A 

A 

A INSTALL JUMPER AT LOCATION "F^ 
8 

8 

3 

8 CHECK PRINTER OPTION JUMPERS 

A USE AT 1200 BAUD 

8 CHECK PRINTER OPTION JUMPERS 

9 

8 SET DRIVER TO 309 BAUD 

A 
19 

3 

2 USE AT 9609 BAUD 

2 USE AT 96090 BAUD 

8 

1 

7 

7 

7 

7 

7 

7 

6 Set Switches 

6 Set Switches 

6 Set Switches 

6 Set Switches 

Dip Switch SWL: 12345678 
91091911 1=0N 
9-0FF 
Set Driver to / bits, Mark Parity 
(Continued) 
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OKIDATA 82A 2 Set switches 
83A 2 Set switches 
Dip Switches: 87654321 
Front 1901900990 1=ON 
Back 191911 P=0FF 
Jumper Blocks: Position A 


QUME SPRINT 5 A 
TELETYPE 43 8 
TI 819 3 


TABLE 2 - Cabling Diagrams 


Ie Apple /// Printer 
| ------------- 1 
2 --—---------- 3 
— — 4 
(oes 7 

2 Apple /// Printer 
L eee 1 
2 mn 3 
en 11 
ee 7 

3 Apple /// Printer 
————— va vra oe — — — —— ee I 
2 o ann 3 
do nen 6&8 
nn il 
7 -———--------- 7 

4. Apple /// Printer 
L mr nn 1 
qc 3 
peace ease 14 
Mo 7 

53 Apple /// Printer 
| ----——--------- 1 
RER 3 
—— m 19 
P senes 7 
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$ Apple /// Printer 
(espias 1 
Dado 3 
— 5 
6 mio 19 
jesse ue. 7 


2 -------- 6 & 8 


Te Apple /// Printer 
je 1 
2 = 3 
e 7 
28 ----—------- 19 
8. Apple /// Printer 
amu) dis unb cen uis rama rur cum uum Cu ga ANNE 3 
6 ------------ 20 
rM E TER MER 7 
9. Apple /// Printer 
| ee 1 
ee 3 
6 ------------ 29 
Pcl A 7 
1g. Apple /// Printer 
2 -———--—-------- 3 
un 5 
6 ---------2--- 29 
tots 7 
A. APPLE SUPPLIED CABLE 
APPLE PART # A3MPP19 
Apple /// Printer 
L ------------- l 
dat 7 
2 ---—---------- 3 
pese 
4 & 5 --------- 8 
8 --------- 4&5 
6 ------------ 29 
28 ------------ 6 
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SERIAL PRINTER INTERFACE PROBLEMS 


Many serial printers use the eighth bit of data to indicate some alternate 
print mode. This alternate print mode mignt be: 


Character graphics 
&xpanded print 
Italics 


If the Apple interface is sending out seven bits of data with even parity, 
the eighth bit will depend on the letter being sent and the printer will 
change to the alternate mode about half of the time. Be sure to set the 
word length and parity options on the Apple and the printer to the same 
value. 
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INTRODUCTION TO TECH NOTES 


The Apple Answer Book has proved to be a very useful tool. It puts the 
answers to the most commonly asked questions at the hand of the people who 
get asked most often. The saga continued with the Apple Answer Book 2. It 
contains more information but in a format that's harder to use. The time 
has come for a book that needn^t be replaced every six months. We 
developed "Tech Notes" as an easily expanded and updated answer to thís 
need. 


Tech Notes is organized on two levels. Each major subject or product is 
given its own number. Then each actual document has its own number. You 
are presently reading the second document under the major subject number 
1000. The page number reflects this structure. This is page 1009.0902.91. 
The 1009 refers to the major subject "General Information”. The ßß2 refers 
to this document, "Introduction to Tech Notes". The last two digits refer 
to which page of the document this sheet is. 


There is an index to all of the major subjects in document 1099.001. Each 
entry in this index will have an index to the individual documents in the 
subject in document number PPP. Document 1000.000 contains two entries, 
the overall major subject index and this document. 


When we add a document we will also send out replacements for any affected 
indexes. Any changes to the information to a document will result in 
mailing out a copy of the affected document with the changed material 
flagged by a "change bar" in the right margin of the changed lines. We 
will include information on how to keep your copy up to date. 
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THE APPLE II KEYBOARD 


The keyboard on the Apple II has an upper-case only encoder. It can 
produce ASCII characters Ø through 95 excluding _ , MN voa ELA. y 
ctrl-[, and ctrl-X. The Apple /// uses the very same encoder. However, 
the Apple /// also has a second keyboard port which allows it to 
independently sense the shift, control, and alpha lock keys, as well as a 
number of other functions. 


It is possible to modify an existing Apple II to allow it to sense whether 
or not the shift keys are depressed. This modification is supported by 
system software such as Pascal 1.1 and Pilot, as well as some word 
processing software. The core of the modification is a wire running from 
the shift keys to button input 2 of the game I/O port, which is unused by 
the paddles. This modification is not recommended for ín-warranty Apples 
and should be only performed by an authorized service technician. 


Since the Apple can now sense whether or not the shift key is being 
pressed, it can now distinguish 51 new characters (ctrl-shift-A thru Z 
excluding M, N, and P, shift-A thru Z, excluding M, N, and P, shift-zero, 
shift-return, shift-ESC, shift-left arrow, and shift-right arrow). This 
raises the total number of distinguishable characters to l4l, which easily 
encompasses the 128 member ASCII character set. 


It isn’t unusual to rearrange the interpretation of these characters in 
software to facilitate the most natural use of the keyboard, so that it 
resembles a typewriter. 


Apple has employed several types of keyboards on the Apple II since its 
introduction, so the modification can take on one of two appearances. On 
the older style keyboard, a wire should be run between pin 2 of the 74LS09 
and pin 4 of the keyboard connector on the keyboard. 


On the newer style keyboard with the "piggy-back" electronic assembly, the 
wire should be run between pin 9 of the 74LSØØ closest to the keyboard 
connector and pin 4 of the keyboard connector. 


In either case, a second wire should connect the bottom of pin 4 at 
location A7 to pin 7 at location Jl4 on the motherboard. Check carefully 
that the wire isn’t connected to pin 7 of Hl4. The keyboard cable acts as 
a connection between these two wires. 


A quicker but less flexible way to connect the "piggy-back" keyboards is to 
wire from pin 24 of the connector between the keyboard and the encoder 
board and pin i of IC Hl4. Hl4 is the IC directly in front of the Game I/O 
connector. Check carefully that the wire isn't connected to pin 7 of Hl4. 
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THE MINI-ASSEMBLER 


The Mini-Assembler is a convenient development tool for small programs. 

For major programming jobs it is suggested that you get a full sized 
assembler like EDASM in the DOS TOOL KIT. To use the Mini-Assembler you 
must first be in Integer BASIC. If you have an Apple II Plus then you will 
need a firmware card or a Language card. There are instructions for the 
Mini-Assembler on page 66 of the Apple II Reference Mnaual. 


INT 


GALL. 131 
F666G 
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APPLE II VS APPLE II PLUS 


The only difference between the Apple II and the Apple II Plus is that the 
Apple II has Integer BASIC and the "old" monitor ROM while the Apple II 
Plus has Applesoft BASIC and the Autostart monitor ROM. Most of the game 
programs available today are written in Integer BASIC and most of the 
business, scientific, and industrial programs require Applesoft, so the 
selection depends on your application. Apple offers firmware cards that 
will supply Applesoft to Apple II owners and Integer Basic to Apple II Plus 
owners. 


THE APPLE II 


MAIN BOARD APPLESOFT CARD LANGUAGE SYSTEM 

ae ic = ee eee ere ee ants T -+ ene — 
| OLD MONITOR | | AUTO START | | | | AUTO START | 
+------- MM -+ +------------ + | | +--~---------- — 
L KETILITIESY ? | | | | 
| INTEGER | | | | 16K RAM | 
| BASIC | | | | | 
ai ~+ | APPLESOFT | des a cr = 
| unused | | | | | | 
+------------ + | | | 4K RAM | | 4K RAM | 
| PROG AID | | | | | | 
+------------- + 42----------- -+ 4R------------ -+ d------------ -— 
| INPUT/ | 
| OUTPUT | 
4---- -- + - — 
| | 

48K RaM : 
| | 
T------------ -+ 

(Continued) 
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IHE APPLE LL PLUS 


MAIN BOARD INTEGER CARD LANGUAGE SYSTEM 
FR------------- + Som ----- + +------ -- ---- =+ $------------ -+ 
| AUTO START | | OLD MONITOR | | | | AUTO START | 
4------------- t Po M —+ | | en — 
| | | (UTILITIES) | | | 
| | | INTEGER | | 16K RAM | 
| | | BASIC | | | 
| APPLESOFT | n n -+ e o L Kaa -+ 
| | | unused | | | | | 
| | ARA + | 4K RAM | | 4K RAM | 
| | | PROG AID | | | | | 
+------- -- + 4------------ -+ T------------ L to... —+ 
| INPUT/ | 
| | OUTPUT | 
T---------2--- + 
| | 
| 48K RAM i 
NM d 
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STOPPING THE BLINKING CURSOR 


The blinking cursor on the Apple”s screen is generated by hardware. NOTE: 
this modification will void your warranty. You can stop the blinking and 
have a plain inverse cursor by lifting pin 13 of IC number B-13 and connect 
it to pin 7 of the same IC. Connecting pin 13 to pin 14 will remove the 
cursor entirely. 


Here is an Applesoft program that will do the same thing in software: 


1g FOR A = 935 TO 941 

20 READ B 

39 POKE A,B 

409 NEXT A 

59 POKE 56,167 

69 POKE 57,3 

79 CALL 1992 

8% END 

199 DATA 72,41,63,145,40,104,76,27,253 


This program assumes that you have DOS booted. If you don’t have DOS, 
delete line 79. 


Run the program and the cursor will be a solid block until the RESET key 
is pressed, there is an IN#@ command, or the Apple is turned off. 


The cursor can be completely eliminated by changing the 63 in line 199 to a 
191. 
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CHARACTER GENERATOR ROM 


The character generator ROM in revision 7 and later Apples can be replaced 
with a user supplied 2716 PROM. This allows the user to program in special 
characters or lower case characters as required. This note describes how 
the characters are mapped in the ROM. 


Characters are stored using eight bytes per character and are arranged in 
the ROM in the order shown in Table 7 on page 15 of the Apple II Reference 
Manual. Lower case characters, if desired, should be mapped ín piace of 
the numbers and punctuation in columns SER and SFP. The starting address 
for each character is the address from Table / multiplied by eight. 


Each character is made up of eight bytes. Each byte represents one row of 
dots. The most significant bit of each byte is ignored by the hardware. 
Ihe lowest addressed byte of each character is the top most row of dots of 
the displayed character. The first and last bits of each row of dots are 
usually set to zero to supply a two dot space between characters. The 
bottom row of dots is usually left set to zero to allow a one row space 
between iines. 


Some lower case character sets use the bottom row for descenders (the 
letter "5", for example). This can cause overlap when the descender is 
directly above an upper case letter like "B". The following diagram shows 
how the characters are built. The three digit numbers are the hexadecimal 
ROM address for each byte and the two digit hexadecimal number is the 
pattern ot on and off bits. 


$208 $08 ...*... s708 SPO s... : $730 S08 ...*... 
S209 S14  ..*.*.. $709 SOD ...... f 673] Sib ERA 
$204 $22  .*...*. 570A SIC ..***.. 2132 0510 au 
S20B $22 .* x, $70B 592 ..... x, S733: 810 Fea 


S20C S3E  .*****, $70C SIE ..****, $734 $3E  .*****, 
$90. 522 Hi $70D $22 .*...*. 8735 SIA ..*.... 
S2DE $22 .*...*. S7PE SIE ..****. S736: C we 


$20F SPP ..... T S70F SPO ....... S737 SOO  ...... 
$216 S3C .k****., 6710. $20. JP asian S738 SOD ....... i 
SoTL. 822 es RIL S20: ¡is 239.500 arraid 
5212 :522 es 8712 $3C  .***x*,, 513% IG. «E 


8213 $3C ..k*k*k**,, $713 $22  .*...*. S73B. S22 Eira", 
S214 622: iX. 614 $22 Fast 5130 229. qq. 
6215. 5692 is $715. $22. afsat: $73D SIE ..*k***, 
$216 $3C .k****,, $716 S3C .k*k*k**.. S73E S02 .....F*. 
$217 SPO ....... S717 SOG: 2.2 S73F SIC ..***,. 
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POWER SUPPLY INPUT FREQUENCY LIMITATIONS 


The Apple II power supply is a switching power supply. It is designed 
to accept 107 to 135 volts from DC to 69 Hz. It will also work at up to 
400 Hz but there is a danger that the circuit that protects the supply 
from short circuits will not work. 
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SPECIFICATIONS 
ELECTRICAL 
AC power 197-132 VAC 6PHz 
DC power at I/O ports 
(46K RAM) 
+ 5v 21.9 amp 
- 5v d 9.25 amps 
+12v @ 1.1 amps * 
-12v @ 9.23 amps 


Power Disapation 
60 watts 


* Can supply 2.1 amps intermittently...20 minutes on aud 19 minutes off 


LSV ERGATA TAL 
cenperature sange 


)perating C to 43C (disk media is limited to 35C) 
Storage -35C to 149C 


xelative tlumidity 
20% to 90% non-condensing 
astitude 
Operating - 1,000 to 15,999 ft 
Non-operating 50,000 ft 


(derate maximum ambient temperature by 1 degree C per LOO feet 
over 5,000 ft) 


PHYSICAL CHARACTERISTICS 


Height 4.5 ia 
Width Lx En 
Length 13.9 in 
weight 12.9 lbs 


SAFETY AND RFI QUALIFICATIONS 


(Continued) 
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The Apple II meets the following agency regulations. 


FCC Part 15, Class B Personal Computers 
CSA 22.2, No. 154-1979 

UL 114 - Office Machines 

VDE 0871/6.28"A"Limit 
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6522 VIÀ 


The 6522 Versatile Interface Adapter is a popular integrated circuit for cise 
with microcomputers because of the many modes of operation available. The 
precursor to the 6522, the 6520, has been used in several interfaces wien no 
difficulty. Unfortunately, although these two parts have identical tizing 
specifications, their operation is different. The 6529 is very tolorant of 
operation outside of the data sheet parameter limits while the 6522 must 
have its timing specifications exactly. 


Ihe most critical timing parameter is the address set-up time which is the 
delay between the chip select and the rising edge of tne iMlz clock. The 
Apple ][^s Device Select and 1 MHz clock are nearly identical, and the 6522 
will not operate under these conditions. The solution is to snorten the 
positive half-cycle of the 1 MHz waveform. This can be achieved by various 
methods, but, since the length of the positive half-cycle is critical, it is 


essential to have a well-controlled circuit to do this. 


The attached circuit is proposed for use with the Apple ][. The 6522 clock 
wavefora is generated by usíng a 74LS74 circuit to delay the positive edge 
of the clock by one cycle of the 7 Miiz clock. The negative edge of tne 
clock is set by the falling edge of the 1 Miiz clock which also holds oft the 
flip-flop until the next cycle. The result is a clock waveform which has a 
shortened positive half-cycle whose leading edge is delayed from the falling 
edge of Device Select by 148 nsec. 


The 6522A is required to meet the data sheet timing parameters. Thé ny 
will usually work but it/s operation cannot be guaranteed. 
=| ng 
DEVSEL | | 
la 
E pa 
CLOCK | | 
HANE. 
(Continued) 
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SUGGESTED SCHEMATIC 


(25) +5 ----------------- K 224 - a -=m + 
| | 
| 4 |. 741,974 |  1d4 | | 
0) COM E «pas? 5|-------.---- 43 Blase | 
MEE. | | | | | 
(36) 7M ------+- | -]3 | +--|11 | i | 
Sok | | | | | | d 
| d | NAE | d oo ido. = 
|| d fo | | 
E dete res eas | Agrees et | | 
Ho Lo + TE 
|o] 
| | 
(41) DEVSEL --------------- Po 0 - 123 — 25|-— | 
(18) R/W ------------ pesos siccus tied seca ate 122 | | 
| | | 24|-----+ 
Jair 9 | | 28|----—+ 
fo) dig ease nn “19 AAA 126 | 
(+3) 26 ------------ 118 la -= |27 | 
(44) D5 ------------ll7 8 | 3|------------- | 28 | 
(45) D4 ------------ i16 3  A4j------------- [29 | 
(40) DI pesce sedes 1153 48 5|------------- 1309 6 | 
C a |14 + [31 | 
(59) D] Sesa ea 7 | mee + ~~ 32 5 | I/O Lines 
(49) DM ----- + 112 j------- a [32 | 
| | | 2 | Port À 
( 5) A3 == +++ 2222-2 - ----- 135 | 
( 4) AZ oc a o a ese fae | and 
CJJ SI erin Sore eee er MN tid | 37 | 
( 2) Af --------- e - - - - - ---- 22200 | 38 x | Port B 
(359 RESET eres Sarasa eras seen seen 134 | 
(38) IR% ==> 21 | 
| 


APPLE TECH NOTES Copyright (C) 1982 by Apple Computer, Inc. 


-— 
—— c -— A A A CUR A cà la — ee D - —— a — [up — — — A eee ee p — — e - A ee eee ee ee — )— M — — — — — — -— eee — — —— — —— —— — —— — 


eu 4? A Uum ara — HÀ AER GER UEM RUD AER WR AER OU SUD GEM AU Up GER GER UAM "a cum AA mi GER MES Gum cue ies UAR UEM AE AE cp m m he cm ee Su r vd c im m ee m CR m mcm DT c RS a l — oe t ey 


0522 VIA = 


The 6522 Versatile Interface Adapter is a popular integrated circuit for use 
with microcomputers because of the many modes of operation availabie. The 
precursor to the 6522, the 6520, has been used in several interfaces with no 
difficulty. Unfortunately, although these two parts have identical timing 
specifications, their operation is different. The 6520 is very tolerant of 
operation outside of the data sheet parameter limits while the 6522 must 
have it’s timing specifications exactly. 


Ihe most critical timing parameter is the address set-up time which is the 
delay between the chip select and the rising edge of the LHZ clock. The 
Apple ][”s Levice Select and i MHz clock are nearly identical, and the 6522 
will not operate under these conditions. The solution is to shorten the 
positive half-cycle of the L Milz waveform. This can be achieved by various 
methods, but, since the length of the positive half-cycle is critical, it is 
essential to have a well-controlled circuit to do this. 


The attached circuit is proposed for use with the Apple ](. The 6522 clock 
waveform is generated by using a 74L574 circuit to delay the positive edge 
of the clock by one cycle of the 7 Miz clock. The negative edge of the 
clock is set by the falling edge of the 1 Mhz clock which also holds off the 
flip-flop until the next cycle. The result is a clock wavetorm which has a 
shortened positive half-cycle whose leading edge is delayed from the falling 
edge of Device Select by 14% nsec. 


The 6522A is required to meet the data sheet timing parameters. The 6522 
will usually work but it’s operation cannot be guaranteed. 


PS D 


(Continued) 
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SUGCESTED SCHEMATIC 


(25) +5 -----------------— R---------------------- A + 
| | | 
| 4 | 74LS74 | 19 | | 
(20) LE eres pH g BN D dE | 
(36): TN eec aa | +--[11 | NE 
E 3 lu | b 3 | | | 
EM 1 | | | 13; HE 
| | "a | mE | | 
| ahr ARAS | ------- + | | 
Sm + | | 
| | 
| | 
(41) DEVSEL ----7----------- Po 123  25|]-— | 
Cle? ee fas |e ea esS 122 | | 
| | | 24) Herr 
ea: E | 28 | -----+ 
(42) D7 ------------ |19 | |------------- 26 | 
(43) D6 ------------ |1 2 | ------------- | 27 | 
(44) D5 ------------ |17 8  3|------------- 128 | 
(45) D4 ------------ 116 3  A4]------------- 129 | 
(46) D3 ------------ 115. 8  5l------------- i30 6 | 
(it APARTE 114. 4  6j-——--------- 131 | 
(48). DL esr ree ene 113 Di 132 5 | I/O Lines 
(49) DØ ------------ 112 g[------------- Er | 
| | | 2 | Port A 
( 3) AB ------------------------------------ 135 | 
(08): aui SaaS Sra eee tete rie TEE ao. E | and 
( 3) Al ------------------------------------ EE | 
TOS li 38 A | Port B 
(31) RESET ---------- 777 134 | 
20) CE [21 | 
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DMA stands for Direct Memory Access. It is designed to allow the hardware 
on an interface card to completely take over the Apple^s memory and I/O. 

The DMA pin on the Apple ][ interface bus disconnects the Apple's 6502 from 
the Apple's address bus, data bus, R/-W signal, and clock. The DMA pin 
should be pulled low immediately after phase D goes low and released when 
phase Ø again goes low. The 6592 is a dynamic device that will lose it’s 
registers” memory if DMA is held low for more that 49 microseconds. Here is 
an example where the DMA lasts for two microseconds. 


Clock d 


The 6302 normally sets up it’s addresses, control, and data while clock Q is 
low. The memory or 1/0 device decodes and readies the data while clock 9 is 
high. The actual transfer occurs when clock Ø goes from high back to low. 
During cycles when DMA is low, the user must supply the address, control, 
and data information for that memory cycle in synchronization with the 
Apple's clocks. 


A scheme to enable unlimited DMA is to point the reset vector to a restart 


routine, assuming the Apple has the Auto-Start ROM, and have the peripheral 
card generate a RESET when the 6502 is to have control of the bus. The 
Apple ][ Reference Manual explains the RESET vector starting on page 36. 
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CONVERSION TO PAL / SECAM 


Apple Computer neither performs nor offers information regarding conversion 
of Apple ]{ computers for operation in Europe. Such conversions are not 
supported and will void your warranty if implemented. 
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TRAVELING WITH AN APPLE COMPUTER 


Many people are concerned about using their Apple Computers overseas. Here 
are some hints: 


STEPDOWN TRANSFORMER 


Use a stepdown transformer to convert from 229V to l119V (or stepup from ll$V 
to 220V if you have a 220V Apple). Buy a 19099 Watt transformer from your 
local hardware store. Cost is about $15 U.S. and it comes equipped with 
adaptor plugs to fit most common sockets. 1000 Watts is about 5 times the 
maximum vou will ever need so don't worry about overloading it. 


The Apple and all peripherals that draw their power from the Apple bus will 
work correctly on either 5f Hz or 69 Hz. This means that disk drives and 
all programs recorded on them will continue to work correctly regardless of 
the line frequency. 


MONITOR 


You must use the monitor or TV that your Apple was designed to work with. 


Using an NTSC (U.S.) monitor with a European Apple (or vice versa) will not 
produce satisfactory results. 


Check with the manufacturer of the monitor or TV to determine if it will 
work with both 5ó and 60 iiz line frequency. 


PERIPHERAL EQUIPMENT 


Check with the manufacturer of any peripheral that must be plugged into the 
wall socket (Printers, Plotters, Hard disks) to determine if they will work 
on both 5% and hØ iiz. 


POWER FLUCTUATLONS 


The Apple power supply will function correctly with voltages between 107V 
and 132V (214V to 264V on a 22@V supply). If the line voltage fluctuates 
outside of these specifications you will need to use a power conditioner to 
insure un-interrupted operation of your Apple. Operation without the 
conditioner will not result in damage to the Apple hardware. However, the 
system may "crash" resulting in loss of data from memory and possible loss 
of data stored on diskette. 
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8809: 26 43 ROL AAH 

@8DB: CA DEX 

A8DC: 19 F8 BPL NXTM2 

08DE: C6 3D DEC AlH : DONE WITH 3 CHAR? 

OBEN: FO F4 BEN NXTM2 YES BUT DO 1 MORE SHIFT 

ÓRE2: 10 =å RPL NXTMN : Nf) 

ARTA * 

AREA: AP M5 TDX #605 ‚5 CHARACTER ADDRESSING MODE 

A836: 20 3F G9 FORM? JSR CETNSP ¡CET 1ST CHARACTER OF ADDRESS 

$9r0. 945 34 STY YSAV 

ØSEL: DD B4 PO CHRANI Y : 1ST CHARACTER MATCH PATTERN? 

(RET: 50 13 BNE FORM3 N 

ÓRFO: 2A 3F G9 JSR GETNSP “YES, GET 2ND CHAR 

Q8F3: DD BA F9 CMP CHAR2,X “MATCHES SECOND HALF? 

08F6: FO ON BEO FORMS : YES 

98F8: BD BA F9 LDA. CHAR? X ‚NO, IS 2ND HALF ZERO? 

BBB: ro Ø7 BEN FORMA ‚YES 

QRFD: C9 Ad CMP ¿SAL ¿NO 2ND HAL OPTIONAL ? 

BBFF: FO 43 BEQ FORMA "YES 

0901: A4 34 LDY YSAV 

$903: 1 FORM3 E ;CLFAR CARRY NO MATCH 

3984: AR FARMS NEY ¡BACK UP ONE CHARACTER 

AA: IP 44 FORMS ROL EMT ‚FORM FORMAT RYTE 

$907: ro A? CPX #503 ;TIME TO CHECK FOR ADDRESS 

(QAO. DO nn RNE FODM7 ESA 

NIRO UM T Tr Ten oen rM d ichs 

B tuus ae DA ABU 

0910: FO Qi BEQ FORM6 ;HIGH ORDER BYTE ZERO 

$912: z3 INX ;NO,.INCR FOR 2-BYTE 

2913: 86 35 FORMÓó STX L ; STORE LENGTH 

0915: A2 03 LDX #593 : RELOAD FORMAT INDEX 

0917: 58 DEY ; BACKUP A CHARACTER 

09:18: 86 3D FORM? STX AlH SAVE INDEX 

9:4: CA DEX ;DOKE WITH FORMAT CHECK ? 

9918: 18 29 BPL FORM2 ; NO 

91D: A5 44 LDA FMT ‚YES PUT LENGTH 

Q91F: OA ASL A : IN LOW BITS 

0929: OA ASL A 

092 5 35 ORA L 

0923: C9 29 CMP 828 

4925: BO 86 BCS FORMB ‚ADD S IF NONZERO LENGTH 

0927: 46 35 LDX L SAND DONT ALREADY HAVE IT 

0929: FO 62 BEQ FORM8 

092B: 89 89 ORA #580 

092D: 85 44 FORM8 STA FMT 

092F: 84 34 STY YSAV 

G931: B9 OP 22 LDA IN,Y ; GET NEXT NONBLANK 

0934: C9 BB CMP #SBB 57 START OF COMMENT 

$936: FO 04 BEQ FORM9 ; YES 

$938: C9 8D CMP #S8D ;A CARRAIGE RETURN ? 
(Continued) 
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MINI-ASSEMBLER FOR THE APPLE 11 


t 


r 


This note covers use of the Apple ]{ nini-assembler only. Instructions for 
Apple ][ Plus users are in 1390.013. This is not a course in assembly 
language programming. For a reference on programming the 65902 
microprocessor, refer to the Synertek Programming manual or any of the 
tutorials available. This note assumes the user has a working knowledge ot 
6502 programming and mnemonics. 


The Apple ][ mini-asseubler is a programming aid aimed at reducing the 
amount of time required to convert a handwritten program to object code. 
Ihe mini-assembler is basically a look-up table tor opcodes. With it, you 
can type mnemonics with their absolute addresses, and the assembler will 
convert it to the correct object code and store it in memory. 


Typing "F666G" will put the user in mini-assembler mode. While in this 
node, any line tvped in will be interpreted as an assembly language 
instruction, assembled, and stored in binary form unless the first 
character on the command line is a °$”. 


If the first character of a command line is a "S", the remainder of the 
line will be interpreted as a normal monitor command, executed, and control 
returned to the nini-assembler. To get out of the mini-assembler, press 
RESET. 


If the first character on the line is blank, the assembled instruction will 
be stored starting at the address immediately foilowing the previously 
assenbled instruction. If the first character is not a blank nor a “$”, 
the line is assumed to contain an assembly language instruction preceded by 
the instruction address (a hex number followed by a ":"). In either case, 
the instruction will be retvped over the line just entered in dis-assembler 
format to provide a visual check of what has been asseubied. 


The counter that keeps track of where the aext instruction will be stored 
is the pseudo PC (Program Counter) and it can be changed by many monitor 
commands (eg. L^, “1%, . a +). Therefore, it is advisable to use the 
explicit instruction address mode after every monitor comzand and, of 


course, when the mini-assembler is first enteted. 


^ 


Errors (unrecognized mnemonic, illegal format, etc.) are signalled bv a 
“beep” and a caret ("^") will be printed beneath the ‚as! character read 
from the input line by the mini-assembler. 


The mnemonics and formats accepted by the mini assembler are the same as 
those listed by the 6592 Programmers Manual, with the following exceptions 
and differences: 


l. All imbedded blanks are ignored, except inside addresses. 


(Continued) 
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MINI-ASSEMBLER, FOR THE APPLE ][ PLUS 


The attached listing is a relocated version of the mini-assembler for the 
Apple ][ Plus with instructions for the Apple ]{ version. This version can 
be BRUN from the disk or BLOADed and start with CALL 2048 from Applesoft. 
To restart use CAll 2051. From machine language the start is 8ØØG and the 
restart is 8030. Users who have Integer Basic available need only enter 
that language and use the instructions in Tech Note 1300.912. 

in 


Please note that the mini-assembler performs a NEW command, so it will wipe 
out any resident Applesoft program. Also note that the mini-asseubler loads 
from $800 to S947. Don’t try to assemble anything into those locations. 


This note covers the operation of the mini-assembler only. It is not a 
course in assembly language programming. For a reference on programming the 
6502 microprocessor, refer to the Synertek Programming manual or any of the 
tutorials available. This note assumes the user has a working knowledge of 
6502 programming and mnemonics. 


The mini-assembler is a programming aid aimed at reducing the amount of time 
required to convert a handwritten program to object code. The 
mini-assenbler is basically a look-up table for opcodes. With it, you can 
type mnemonics with their absolute addresses, and the assembler will convert 
it to the correct object code and store it in memory. 


Typing “F666G" will put the user in mini-assembler mode. While in this 
mode, any line typed in will be interpreted as an assembly language 
instruction, assembled, and stored in binary form unless the first character 
on the command line is a "$'. 


rf the first character of a command line is a "S$", the remainder of the line 
will be interpreted as a normal monitor command, executed, and control 
returned to the mini-assembler. To get out of the mini-assembler, press 
RESET 


If the first character on the line is blank, the assembled instruction will 
be stored starting at the address immediately following the previously 
assembled instruction. [f the first character is not a blank nor a "S^, the 
line is assumed to contain an assembly language instruction preceded by the 
instruction address (a hex number followed by a ":"). In either case, the 
instruction will be retyped over the line just entered in dis-assembler 
format to provide a visual check of what has been assembled. 


The counter that keeps track of where the next instruction will be stored is 
the pseudo PC (Program Counter) and it can be changed by many monitor 
commands (eg. ^L^, ^T^, . + +»). Therefore, it is advisable to use the 


explicit instruction address mode after every monitor command and, of 
course, when the mini-assembler is first entered. 


(Continued) 
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2990: ARRE TOI ke RARA RARA dee 
0909: T ^ 
09909: * APPLE [I k 
DOOD: * — MINI-ASSEMBLER * 
090909: ^ . 
0009: koc kx x A ko ko ko L de KR A A ko kokkk 
$92E: FORMAT  EQU S2E 
$82F: LENGTH EQU SOF 
0931: “ODE EQU 531 
0033: PROMPT  EQU $33 
#934: YSAV EQU S34 
$035: L EQU $35 
003A: PCL EQU $34 
OO3B: PLH EQU 538 
093D: ALH EQU $3D 
9030: AS EQU $3E 
OO3F: A2H EQU S3F 
0942: ASL SQU $42 
0543: AAT LOU $43 
095. : PMT EGU 544 
DOY: Ls EQU s209 
D64B: NEW EQ SD64B 
F88E: ENSUS2 ENE SF88E 
F8DO: INSTDSP EQU SFODP 
F944: PRBL2 EGU SF94A 
F953: PCADJ EQU SF953 
7984: CHARI EQU SF9BS 
SOBA: CHAR2 EQU SF9BAÀ 
FOCO: MUEML EQU SFICH 
FADO: “NEMR EQU SFAOD 
FCLA: CURSEP -EQU SFCLA 
EDO7: GETLNZ EQU SFD67 
FIED: COUT EQU SFDED 
FEQ: BLI EQU SFEQ 
FE78: AlPCLP EQU SFE78 
FF3A: BELL EQU SFF3A 
FFA7: GETNUM EQU SFFA7 
FFBE: TOSUB EQU SFFBE 
FFC7: ZMODE EQU SFFC7 
FFCC: CHRTBL  EQU SEFCC 
Depp: ORG S899 
$8990: 20 4B D6 JSR NEW : SCRATCH ANY BASIC PROGRAM 
0893: 49 pÉ LDA #500 
0805: 8D HØ 98 STA #59806 
0808: 4c 9D $8 JMP RESETZ ; BRANCH TO START OF MINI/ASSEM 
089g: E9 81 REL SBC #$81 ;IS FMT COMPATIBLE 
G8OD: 4A LSR A "WITH RELATIVE MODE? 
080E: DO 14 BNE ERR3 sus 
0819: AA4 3F LDY A2H 
(Continued) 
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2. All addresses typed in are assumed to be in hex (rather than 


decimal or symbolic). A preceding "S" (indicating hex rather 
than decimal or symbolic) is therefore optional, except that 
it should not precede the instruction address). 


3. Instructions that operate on the accumulator have a blank 
operand field instead of ‘A’. 

4. When entering a branch instruction, the argument of the branch 
mnemonic should be the address of the target of the branch. If 
the destination address is not known at the time the 
instruction is entered, simply enter an address that is in the 
neighborhood, and later re-enter the branch instruction with 
the correct target address. 


NOTE: If a branch target is specified that is out of range, the 
nini-assembler will flag the address as being in error. 


5. The operand field of an instruction can only be followed by a 
comment field, which starts with a semicolon (";"}. Obviously, 
the mini-assembler ignores the field and in fact will type over 
it when the line is typed over in disassembler format. 


6. Any page zero references will generate page zero instruction 
Formats if such a mode exists. There is no way to force a page 
zero address to be two bytes, even if the address has leading 
zeroes. 


In general, to specify an addressing type, simply enter it as it wouid be 


listed in the disassembly. For information on the disassembler, see page 
49 of the Apple ][ Reference Manual. 
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$877: C5 43 CMP A4H ;MATCH ? 
$879: DO OC BNE NEXTOP ;NO, TRY NEXT OPCODE 
087B: A5 44 LDA FMT 
$87D: A4 2E LDY FORMAT ;GET TRIAL FORMAT 
087F: CO 9D CPY #59D ‚IS TRIAL FORMAT RELATIVE? 
$881: FO 38 BEQ REL : YES 
0883: C5 2E CMP FORMAT : SAME FORMAT? 
0885: FO 9F BEQ FINDOP ‚YES 
0887: C6 3D NEXTOP DEC AlH ;NO, TRY NEXT OPCODE 
$889: DO DC BNE TRYNEXT 
088B: E6 44 INC FMT : NO MORE, TRY WITH LEN=2 
88D: C6 35 DEC L WAS L=2 ALREADY? 
ÖBSF: FO D6 BEQ TRYNEXT : NO 
0891: 
0891: A4 34 ERR LDY YSAV ‚YES, UNRECOGNIZED INST. 
$893: 98 ERR2 TYA 
1894: AA TAX 
0895: 20 4A F9 JSR PRBL2 ;PRINT ^ UNDER LAST READ 
0898: A9 DE LDA #SDE ;CHAR TO INDICATE ERROR 
1894: 28 ED FD JSR COLT : POSITION 
089D: 20 EA FF RESETZ JSR BELL 
$8AO0: Ad Al NXTLINE LDA £SAl > PUE 
08A2: 85 33 STA PROMPT : INITIALIZE PROMPT 
G@8A4: 20 67 FD JSR GETLNZ :GET LINE 
08A7: 20 C7 FF JSR ZMODE ;INIT SCREEN STUFF 
Q8AA: AD 00 02 LDA IN :GET CHAR 
$8AD: C9 AO CMP #SA0 ;ASCII SPACE? 
O8AF: FO 13 BEG SPACE ; YES 
V8Bl: C8 INY : 
08B2: C9 A4 CMP #SA4 :ASCII ^$^ IN COL 1? 
08B4: FO 92 BEQ FKMON ;YES,SIMULATE MONITOR 
9856: 88 DEY :NO, BACKUP A CHAR 
08587: 20 A7 FF JSR GETNUM :GET A NUMBER 
Ø8BA: C9 93 CMP #593 ;^1^ TERMINATOR? 
08BC: DO DS ERR4 BNE ERR2 : NO, ERR 
O8BE: 84 TXA 
Ø8ƏBF: FO D2 BEQ ERR2 :NO ADDR PRECEDING COLON 
Ø8Cl: 29 78 FE JSR AlPCLP : MOVE ADDR TO PCL, PCH 
Q8Cà: A9 f3 SPACE LDA f S83 ;COUNT OF CHAR IN MNEMONIC 
08C6: 85 3D STA AlH 
08C8: 20 EF 09 NXTMN JSR GETNSP «GET 1ST MNEMONIC CHARACTER 
$8CB: OA ASL A 
@8cC: E9 BE SBC #SBE ‘SUBTRACT OFFSET 
G8CE: C9 C2 CMP #$C2 «LEGAL CHARACTER ? 
48DO: 99 Cl RCC ERR2 ; NO 
(8Dn2: OA ASL A : COMPRESS-LEFT JUSTIFY 
ARDI: OA ASL A 
ARNG: ^? Nd LDX #604 
ARDA: GA NY TM) AST, A :DO 5 TRIPPLE WORD SHIFTS 
08507: 26 42 ROL A4L 
( Continued) 
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Lrrurs (unrecognized mnemonic, illegal format, etc.) are signalled by a 
"beep" and a caret ("^") will be printed beneath the last character read 
from the input line by the mini-asseubler. 


The mnemonics and formats accepted by the mini assembler are the same as 
those listed by the 6592 Programmers Manual, with the following exceptions 


and differences: 
1. All imbedded blanks are ignored, except inside addresses. 


2, All addresses typed in are assumed to be in hex (rather than 

decimal or symbolic). A preceding "S" (indicating hex rather 
than decimal or svmbolic) is therefore optional, except that 
it should not precede the instruction address). 


3. Instructions that operate on the accumulator have a blank 
operand field instead of "A". 


4. When entering a branch instruction, the argument of the branch 
"nenonic should be the address of the target of the branch. If 
the destination address is not known at the time the 
¿instruction is entered, simply enter an address that is in the 
i;eishborhood, and later re-enter the branch instruction with 
the correct tarzet address. 

NOTE: Lf a branch target is specified that is out of range, the 


- li a 


iini-assembler will flag the address as being in error. 


5. The operand field of an instruction can only be followed by a 
conment field, which starts with a semicolon ("3"). Obviously, 
the mini-assembler ignores the field and in fact will type over 
it when tne line is typed over in disassembler format. 

0. Anv page zero references will generate page zero instruction 
Syrmats if such a mode exists. There is no way to force a page 
zero address to be two bytes, even if the address has leading 
zeroes. 


[n general, to specify an addressing type, simply enter it as it would be 


listed in the disassembly. For information on the disassembler, see page 
49 of the Apple ]{ Reference Manual. 
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293A: 
$93C: 
d93F: 
093r: 
2942: 
2943: 
$955: 
4947: 


APPLE 


DO 89 
4C 67 


08 


B9 00 Q2 


C8 
C9 AO 
FO r$ 
OD 


TECH 


NOTES 


FORM9 


GETNSP 


BNE 
JMP 
* 


LDA 
[NY 
CMP 
BEQ 
RTS 


ERRÁ SNO, ERR 

TRYNEXT 

IN,Y 

#SA0 -GET NEXT NON BLANK CHAR 
GETNSP 
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2812: A6 3E LDX A2L : DOUBLE DECREMENT 

$814: DO Øl BNE REL2 

0815: 38 DEY 

0917: CA REL2 DEX 

4318: BA TXA 

0819: 13 CLE 

PSta: Z5 JA SBC PCL ‚FORM ADDRESS PC-2 

0317: 35 BE STA A2L 

dels: 10 øl BPL REL3 

0820: C8 INY 

p821: 98 REL3 TYA 

0822: =5 3B SBC PCH 

4824: DØ 6B ERR3 BNE ERR -TQ FAR TO BRANCH ERROR 

0826: * 

$826: A4 2F FINDOP LDY LENGTH 

4828: 89 3D OM FNDOP2 LDA AlH,Y ‘MOVE INST TO (PC) 

0325: 91 3A STA (PCL),Y 

0820: 38 DEY 

0822: 19 F8 BPL FNDOP2 

j330: 20 LA F JSR CURSUP 

03833: 20 1A FC JSR CURSUP : RESTORE CURSOR 

4836: 26 Do r8 JSR INSTDSP ;TYPE FORMATTED LINE 

93839: 29 53 r9 JSR PCADJ : UPDATE PC 

de3c: 34 3B | STY PCH 

D33E: 85 3A STA PCL 

0340: 4C AD $8 JMP NXTLINE “GET NEXT LINE 

3843: 20 BE FF FKMON3 JSR TOSVB :GO TO DELIM HANDLER 

3846: AA 34 LDY YSAV : RESTORE Y-INDEX 

$848: 20 a7 FF FKMON JSR GETNUM ;READ PARAM 

$548: 84 34 STY YSAV ; SAVE Y-INDEX 

3840: AD 17 LDY #$17 : INIT DELIM INDEX 

PS4F: 88 FKMON2 DEY "CHECK NEXT DELIM 

2950: 30 4B BMI RESETZ : ERR IF UNRECOGNIZED DEL LN 

0352: D9 CC FF CMP CHRTBL,Y ;COMPARE WITH DELIM TABLE 

4855: DØ F8 BNE FKMON2 : NO MATCH 

$357: CO 15 CPY #$15 "MATCH, IS IT CR? 

0859: DØ £8 BNE FKMON3 ;NO HANDLE IT IN MONITOR 

0858: A5 31 LDA MODE 

(85D: AD DH LDY #509 

Ø85F: C6 34 DEC YSAV 

0861: 20 909 FE JSR BL1 ; HANDLE CR OUTSIDE MONITOR 

0864: 4C AD 08 JMP NXTLINE 

0867: * 

$867: A5 3D TRYNEXT LDA AlH ;GET TRIAL OPCODE 

0869: 29 8E F8 JSR INSDS2 :GET FMT + LENGTH FOR OPCODE 

@86C: AA TAX 

$86D: BD DD FA LDA MNEMR,X :GET LOWER MNEMONIC BYTE 

4870: C5 4 CMP A4L ; MATCH? 

0872: DØ 13 BNE NEXTOP : NO, TRY NEXT OPCODE 

0874: BD CO F9 LDA MNEML, X ;GET UPPER MNEMONIC BYTE 
(Continued) 
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ERRATA - APPLE II REFERENCE MANUAL 
A2LO991A 
038-994-91 


Page 4 
Due to continuing cost reductions on 16K RAMs, current revisions of the 
Apple II will accept only 16K RAMs. 


Page 7 
Table 2, the backspace key (<-) and the forward copy key (->) are reversed. 


-> $95 $95 $95 $95 
<- $88 $88 $88 588 


Page 9 
2nd Paragraph, the pins carrying the video signals are referred to as being 
on the left side of the board. They are on the RIGHT. 


Page if 
The photograph refers to a Revision 6 Apple. Revision / and later Apples 
will look slightly different. 


Page 10 
The Eurapple modification is not complete and we do not support or 
recommend modification of Apples for European television signals. 


Page ll 
The photograph refers to a Revision 6 Apple. Revision / and later Apples 
will look slightly different. 


Page 23 
The photograph refers to a Revision 6 Apple. Revision / and later Apples 
will look slightly different. 


Page 25 
First paragraph, line 4; The address is actually $CP4P instead of SCO4F. 


Page 31 
Paragraph 3, line 3, “the leftmost column" should read "the rightmost 
column” 


(Continued) 
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Page 31 

Table 11 should read: 
LEFT EDGE 32 s20 0/ 8/39  $Ø/$ 98/527 
WIDTH 33 821 0/39/39 $@/$27/$27 
TOP EDGE 34 $22  49$/ 0/23 $@/sS M/s17 


BOTTOM EDGE 35:523 0/24/24 $$/$18/518 


Page 35 
ESC E “When COUT detects this" should read "When RDKEY detects this" 


Page 36 
The Autostart ROM initializes the annunciators Ø and L to OFF and 
annunciators 2 and 3 to ON. 


Page 37 

Paragraph 5 refers to to using call -1169 to set $3F4 to XOR of $3F3 in 
autostart reset vector. This may garbage the diskette in drive 1 if used 
on a non-autostart system. 


Page 4/7 
The line of monitor command just under the first paragraph should read 


AQ: FF FF AD 30 CÓ 88 DØ G4 C6 DL FØ 08 
*:CA DO F6 A6 PØ AC G2 PP 69 


Page 70 
Paragraph 2, the page 3 memory usage chart is actually on page 65 of the 
manual instead of page 62. 


Page 70 
RAM Configuration Blocks are not included on Revision 7 and later Apple 
boards. 


Page 7/4 
The Zero Page memory maps are incomplete.  Applesoft also uses $D6 and 
Applesoft HI-RES uses $19 to SID. 


(Continued) 
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Page 79 Table 22 
The line for $C@6 should be 


SÓ $1 $2 $3 $4 $5 $6 $7 
SCH69 cin pb@ pbl pb2 gec gel ge2 gel 


Page 8l 

Paragraph 3 recommends IOSAVE and IORESTORE. These routines must be used 
with caution because if any other routine in the system uses them, they 
will overwrite your information. The 6592 stack is a better place to save 
the registers. 


Page 84 
Expansion ROM, paragraph 3, This flip-flop should be turned on by the 
I/O SELECT signal, not the DEV SEL signal. 


Page 39 
The photograph refers to a Revision 6 Apple. Revision 7 and later Apples 
will look slightly different. 


Page 89 
The pointer to the USER 1 jumper is wrong. See the photograph on page 99 
for the correct location. 


Page 9 Paragraph 5 
RDY, RES, IRQ, NMI lines are held high by a 1099 ohm resistor, NOT 3309 
ohm. : 


Page 91 
Data from 6502 (read) and Data to 6502 (write) are reversed. They should 
be: 


Data from 6502 (write) 
Data to 6502 (read) 


Page 96 
Paragraph 4, line 5, the 7415283 is at location El4. 
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Page 1609 

The Apple^s new built-in keyboard is built around a AY-5-369% keyboard 
encoder. The inputs to this ROM, on pins 17 through 26 and 36 through 4f 
are connected to the matrix of keyswitches on the keyboard. The outputs of 
this ROM are buffered by a 74LS@4 and are connected to the Apple keyboard 
connector. 


The keyboard decoder rapidly scans through the array of keys on the 
keyboard, looking for one which has been pressed. This scanning action is 
controlled by the free running oscillator made up of three sections of a 
74LS09 at location B3 on the separate encoder board. The speed of this 


oscillation is controlled by C7, R7 and R8 on the encoder board. 


Page 194 
Ihe +12 and -5 volt levels are documented on page 92 as +11.8 and -5.2. 
The levels will vary from Apple to Apple. 


Page 1907 Pin 19, SYNC, is connected only on Apples manufactured for sales 
overseas. 


Page 197 
Pin 21, RDY, is pulled high with a 1090 ohm resistor to +5 volts. 


Page 197 
Pin 22, DMA, is held high by a 1488 ohm resistor to +5 volts. This signal 
will stop the 6502 clock. It should not be held low for more than two 


clock cycles or the 6502 internal registers may be lost. 


Page 108 
Pin 28, INT IN, is the second item on the page and is mislabeled 26. 


Page 198 
Pin 32, INH, is pulled high by a 1999 ohm resistor. 


Page 198 
Pin 35, COLOR REF, is connected only on Apples manufactured for sales 
overseas. 


Page 119 Figure 3 should be labeled: 


ROTATE ONE BIT RIGHT (MEMORY OR ACCUMULATOR) M or A. 


(Continued) 
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Page 129 
The Processor status word should be 


7 0 
+---4-- —-- 4-4 ta tn an 
INTIVA LER DER AAA EA PROCESSOR STATUS WORD, "P" 
R--—R-—R---—R—-—R--—-—-—--—k--—k 


~ 


This bit is undefined. 


Page 121 
Note 1 should read "Bits 6 and 7 are transferred to the Status Register. 
If the result of A AND M is zero, then Z-1; otherwise Z-9." 


Page 127-128 

The unimplemented opcodes are shown as NOPs, which is wrong. $EA is the 
only code defined as NOP. The others should not be used as they perform 
undefined operations. 


Page 128 
Op-code SAD is a LDA, Absolute 


Page 137 
The addresses starting at line 199 should be: 


CLRANÓ EQU 50458 
SETANG EQU SC59 
CLRANL EQU $C@5A 
SETANL EQU $CQ5B 
CLRAN2 EQU SC95C 
SETAN2 EQU $C@5D 
CLRAN3 EQU $C@5E 
SETAN3 EQU SCÓ5F 


Page 143 
Starting at address SFA6F the comments should read: 


FA6F LDA CLRANÓ ¡ANA = TTL LO 


FA72 LDA CLRANL ;ANl = TTL LO 
FA/5 LDA SETAN2 ;AN2 = TTL HI 
FA78 LDA SETAN3 ;AN3 = TTL HI 
(Continued) 
APPLE TECH NOTES Copyright (C) 1982 by Apple Computer, Inc. 


Page 165 
The comment after address SFCAC should read 


1.9204 USEC * (13+27/2*A+5/2*A*A) 


Pages 172-176 
These tables were cut up to fit the pages so they are no longer in numeric 
or alphabetic order. 
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STOPPING THE BLINKING CURSOR 


The blinking cursor can be disabled by invoking the 89-column card 
firmware. The command to do this is: 


PRE 3 


tf you don’t have an 89-column card, the firmware is still there. The 
command to invoke it is: 


POKE 49162, @ 
PRÉ 3 


This will also gain you access to the other extended features of the 
89-column card in 4P-column mode. 
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THE APPLE II CASSETTE INTERFACE 


INTRODUCTION: 


This note is to explain the cassette interface built into the Apple II and 
Apple II plus. Included is information on the format and use of the read 
and write subroutines. It is assumed in this note that the cassette 
recorder is in the proper mode, play or record, when the read and write 
routines are executed. Also note that the timing is approximate and may 


vary from one Apple to another. 


RECORDS: 


A record is a block of binary data. This data may be a BASIC or APPLESOFT 
program, a machine language program, or just binary data. Records 
representing BASIC or APPLESOFT programs are really two records, the length 
of the program and the actual program. A record consists of a header, sync 
bit, the actual data, and a checksum byte for error detection. 


MONITOR RECORD FORMAT 


T------- —--4- => -- --- + - ++ 
| HEADER {S| DATA ic| 
fw wr ow app -- 2 —À 


BASIC PROGRAM RECORD FORMAT 


Ho —-+--- 44 - - ---- S HU o +-+ 
| HEADER |S| LB |C| HEADER ISl PROGRAM Ic] 
4-------- +-+--- 4-4 ------ b —+—+ 


KEY: 5 = SYNC BIT 
C = CHECKSUM BYTE 
LB = BASIC PROGRAM LENGTH 


THE HEADER: 


The header consists of lØ seconds of 779 Hz tone, (l cycle equals 1399 
microseconds). This is enough time for the cassette motor to get up to 
speed and the plastic tape leader to go by. There is also a shortened 
header between the BASIC length bytes and the BASIC program itself. This 
header is generated by a subroutine called HEADR. The value of the 
accumulator on entry controls the length of the header tone. This can vary 
from 9.2 seconds to 4$ seconds. On entry the X register should be É and 
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the carry flag should be set. HEADR also generates a sync bit at the end 
of the tone. HEADR resides at hexadecimal address SFCC9, or decimal 
address -882. 


THE LAST CYCLE OF HEADER TONE AND SYNC BIT 


---+ p------———-—-- + geen n 
| | | | | 
eee eee eene + ++ 
| 130% microseconds | 209] 259 | 

header tone | sync bit | 


THE SYNC BIT: 


The sync bit is one half cycle of 2599 Hz, (209 microseconds) and one half 
cycle of 29869 Hz, (25% microseconds). It is used to signal the end of the 
header tone and the start of the data. It is generated by HEADR. 


THE DATA: 


The data is recorded on the tape with a low starting address and a high 
ending address. Each byte of data is shifted out most significant bit 
first, least significant bit last. A zero bit is made up of one cycle of 2 
kHz, (256 microseconds per half cycle) and a one bit is one cycle of 1 kHz, 
(586 microseconds per half cycle). This works out to 2000 baud for zeros 
only and 1999 baud for ones, or an average of 1500 baud. 


A ZERO BIT AND A ONE BLT 

daesh $--------- + + 
| | | | | 
+ ++ 4 un 
| 599 usec | 1909 usec | 


THE CHECKSUM: 


All during reading or writing each data byte is EXCLUSIVE OR-ed with a 
checksum byte. This byte is written on the tape at the end of the data 


block. If the checksum computed during a read agrees with the checksum 
that was written out then the data is probably good. This method will 
detect an odd number of errors for any of the eight bits of the byte. 
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WRITING DATA: 


The cassette output circuitry is quite simple. It is a flip-flop connected 
through a voltage divider to the jack on the back panel of the Apple. Any 
time the address SCÓ20 is accessed this flip-flop changes state. Accessing 
the flip-flop once every 500 microseconds generates a 1096 Hz tone. 


READING DATA: 


The cassette input circuit is more complicated. It consists of a 7/41 
operational amplifier configured as a zero crossing detector. That means 
that whenever the voltage at the input jack goes from positive to negative 
(or negative to positive) the output of the amplifier switches from a i to 
a Ø (or B to 1). The detector is accessed by any read to address SCH6O. 
The sign bit (most significant bit) of the byte read reflects the detector 
Status. The read routines continually EXCLUSIVE ORs this bit with the 
value most recently read to detect a change in state. The amount of time 
required to change state indicates the incoming frequency which then is 
used to determine if a one or a zero has been received. After detecting 
the first zero crossing at the start of the header, the read routine uses 
HEADR to generate a 3.5 delay then waits for the sync bit. It then reads 
the data and puts it in the specified memory range. 


USING THE CASSETTE INTERFACE: 
To either read or write all you need do is specify an address range and 
execute the read or write subroutine. The address range is stored in four 


bytes, two for the first address to be saved and two for the last to be 
saved. In both cases the least significant byte is first. 


FROM THE MONITOR: 
If the start is $800 and the end is $9FF then 


800.9FFW will write the data to the cassette and 
800 .9FFR will retrieve it. 
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FROM MACHINE LANGUAGE: 


Again if the start is $800 and the end is $9FF then store the address 
range, 


LDA #589 

SLA 590 starting address low 
LDA £598 

STA $3D starting address high 
LDA #SFF 

STA S3E ending address low 

LDA #599 

STA S3F ending address high 
JSR SFEDC write to block to tape 


The JSR SFEDC will write the data to the cassette or JSR $FEFD can be used 
to read from the cassette. 


FROM BASIC: 


First set up the address range. If S = the start and E = the end then from 
integer BASIC, 


POKE 69,S MOD 256 
POKE 61,S / 256 
POKE 52,E MOD 256 
POKE 63,E / 256 


or from APPLESOFT, 
POKE 60,S - INT(S / 256) * 256 
PUKE 61,8 / 256 
PURE 62,E - INT(E / 256) * 256 
POKE 63,E / 256 


Then to write out to cassette CALL -397 or to read in from the cassette 
CALL -259. 
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CASSETTE TAPE LOADING PROBLEMS 


There are several possible reasons for a cassette tape load to fail. The 
following list is presented in the order of the most probable cause. 


. Try adjusting the volume and tone controls on the recorder. 

Try moving the recorder at least 18 inches away from the TV. 
Try another cassette to check if yours is defective. 

Try another recorder to see if yours is compatible and aligned. 
Try another Apple to see if yours is OK. 

Try cleaning the recorder head. 

. Try unplugging the cable to the MIC jack. 


“A Oin & woh rm 
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AUTO-RUN APPLE WITHOUT DOS 


Some applications require that an Apple start running an Applesoft program 
from power-up without human interaction. This is easy with the disk and 
Auto-Start ROM. Simply initilaize the diskette with the desired program in 
memory and the disk will boot and run it when the power comes on. But 
sometimes a disk drive is undesirable, especially where there is only one 
program to run and the cost must be kept low. So here is a way to have a 
card that will load and run an Applesoft program automatically on power-up 
in any Apple II Plus. 


I will assume the use of a card like the Mountain Computer ROMH that has a 
256 byte "control ROM" and room for some larger ROMs to store the Applesoft 
program. On the ROM* this is a bank of up to six 2716 type EPROMs. Using 
EPROMs has the advantage that you can change your Applesoft program later 
by erasing the EPROMs and reprogramming and the disadvantages of higher 
cost and using more power from the Apple's power supply. The power 
consumption of the EPROMs won^t be a problem if the Apple isn't filled with 


cards. 
The software in the control RUN is required to do five things: 


|!) Pretend that it’s a disk controller card so that the Auto-Start 
20M will execute it's code. 


> Initialize Applesoft. 


3) Move an image of the Applesoft program down from the ROMs into 
the proper area of KAM. 


4) Set up the required Applesoft pointers for the end of the 
program. 


>) RUN the program. 


All that’s needed to convince the Auto-Start that there^s a disk controller 
card out there is to have a ROM whose first four odd bytes match the Apple 
P5 or PSA PROM. Tf the monitor finds a ROM that matches it in slot“, TE 
will do a jump to SCNÓ9. The routine that does this starts at SFAA6 and is 
listed on page 144 of the Apple LI reference manual. The first eight bytes 
in the control ROM will be 


24 29 24 HØ 24 03 24 3C 
‘ote that by having the even numbered bytes equal to $24, (BIT Page zero) 


when the code is executed starting at $CNØØ nothing will happen until the 
byte after the $3C. 
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The proper way to initialize Applesoft is to jump to SE@@@. Unfortunately 
this entry into Applesoft falls into the normal command level routine. To 
regain control so that the controi ROM can load a program we can use the 
same trick that DOS uses. As soon as Applesoft reaches it's command level 
it prints a prompt, ("]") and waits for the user to type in a command. 
Since all input and output in the Apple is handled through two pointers in 
RAM, we can divert the input routine to point back into the control ROM. 
This will leave several levels of subroutine on the 6502 stack but 
Applesoft will re-initialize the stack when we RUN the program so it 
doesn't matter. 


Now the question becomes what address to put into the pointer. The control 
ROMs address will change depending on which peripheral slot its plugged 
into. The low byte is just the offset from the start of the ROM since the 
address always starts on a 256 byte boundary but the high byte could be 
anything from SCl to $C7. When the Auto-Start ROM looks for a disk 
controller card it saves the high order byte in S/F8. So the contents of 
$38 and $39, the input pointer, becomes the oftset which is stored at 
location S778. Then «e can jump to SEØØØ to initialize Applesoft confident 
that we will regain control when it’s done. 

For the next step a copy of the image of the application program needs to 
be programaed into the ZPROMs. The program starts at the address pointed 
to by S67 and 358 and ends at the address pointed to by SAF and SB. The 
contents or dress pointer, SAF and 530, vill be inserted in the 
control +M at boc LY and S23. When control comes back through the 
input routine pointer, lesoft has already initialized $67 and S68. So 
the next step is to move the image of the Applesoft program down to where 
it originally came froma. How this is done will depend on the hardware of 
the RUM card and the length of the Applesort program. If you use the Apple 
firmware card vou wili nave to address the soft switch to select the 
firmware card ind then address the switch tain to re-select the Applesoft 
Rats. Sith the AOMPLUS it could be as simple as using the monitor move 


q 
ene end ad: 

S 

+ 

t> 


- m 


3 


Ft, to move a program of less than 2 kilobytes long. 


UE 


GOLE L TIS ; 


There is a littie more initialization to be done before the Applesoft 
2rogria can be RUN. The end ot program pointer dentioned earlier must be 
out into $69 and $54 and one more Applesoft routine must be called. 
Untortunately this one also drops into Applessit”s command mode so we have 
to modify the input pointer again to poírt to a third part of the control 


RUM Once this is done the final initialization can be done with a jump to 


And now the final nart, we need to reset the input pointer so that the 
program can input normally from the keyboard and actually RUN the program. 
To make things easier there is a routine set by the Auto-Start ROM that 
will set the input pointers to the keyboard at location SFE89. Then all 
that^s left to do is jump to $D556 which will run the program. 
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For a bit of finesse, if we put a $89 into location SD6, the user will not 
be able to list the program. In fact any attempt to do any Applesoft 
command except LOAD from cassette will cause the program to RUN. Also, by 
changing the reset, vectors in the Auto-Start ROM to point to the RUN 
routine, the program will become very difficult to stop or modify. (To 
change the reset vector, load memory starting at $3F2 with 66 D5 79. See 
page 36 and 37 of the Apple II Reference manual for more details) 


INE. ES LLO 


This listing is all done relative to the start of the ROM so all address 
are given as one byte. If you use an assembler, simply origin the code in 
RAM and when it is prograumed into the control ROM it will work just fine. 
The routines are not arranged in order of execution so that the move 
routine will he at the end since the length of the move routine will vary 
with the hardware requirements. Just be sure that the three byte jump ís 


inserted behind the move routine. 
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Page l500.2903.94 Apple II interfacing Issued 25 Jun 82 
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* THE FIRST 4 INSTRUCTIONS LOOK LIKE A DISK BUT DON i DO ANYTHING 


* 

Ø: 24 29 BIT 529 

02: 24 00 BLT S09 

04: 24 3 BIT S63 

06: 24 3C BIT $3C 

* 

* TALS PART INITIALIZES APPLESOFT AMD GETS CONTROL BACK AT ENTRY2 
* 

3: 39 LA ENTRYL  LuA # ENTRY2 
QA: 35 38 STA KSUL 

DC: A5 F8 07 LDA S®7F8 

DE: 85 39 STA KSWH 

Ll: 4C d EP JMP COLDSTART 
* 


* RESET INPUT TO THE KEYBOARD AND RU&4 THE PROGRAM 


* 

14: 29 39 FE ENRTYI JSR SETKBD 

17: 4C 66 US JMP RUN 

* 

* FINISH INLTIALIZATION & MOVE THE PROGRAM TEXT DOWN FROM THE ROMS 
* 

i5: 39 dà ENTRY2 LDA # ENTRY3 
Ley 45 38 STA KSWL 

LE: AQ LL LDA # LENGTH-L 
29: 85 05 STA LOMEML 

223 49 "t UDA $ LENGTH-H 
24 185 DÀ STA LOMEMH 


INSERT YOUR MOVE ROUTINE HERE FOLLOWED: BY 


«C 22 D4 JMP INIT PART 2 
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INTERRUPTS = 


INTRODUCTION: 


This note describes the interrupt handling routines in the Apple ]Í. L 
must assume that the user is familiar with the 6502 interrupt requirements 
as defined in the Synertek Programming and Hardware manuals (A2L0993 and 
A2LO092). This note applies to the interrupt request (IRQ). The use of 
the non-maskable interrupt (NMI) in a disk system is not recommended. The 
data and programs on the disk may be destroyed if an NMI occurs while the 
Apple is writing data to the disk. The DOS disables IRQ during critical 
code making it relatively safe to use. 


HARDWARE: 


The Apple peripheral slots have three pins defined for interrupts. 


140, Interrupt ReQuest pin 30 
Lat ix, daisy chain in pin 28 
INT ƏUT, daisy chain out pin 23 


The daisy chain structure allows an interface card to disable the next 
higher number card From requesting an interrupt. Slot ® has the highest 
priority and slot 7 has the least. 


SLOT 
2 l 2 7 
+-—+ Ka + +--+ hot 
| | ! | | | | | 
| | | |j | | | d 
IN; ------- + F--R--------- E--R-- ~ = bt 
| | | | | o3 | | 
IT Ope | [o Li io EE jo Ii | 
and OUT ---| -F--------- + R--------- bote --- --k | 
| | | d i | | | 
hc | | i | | | 
+--+ +--+ +--+ +--t 


The system was designed so that if INI IN for a slot is low then that slot 
may not generate an interrupt. Each slot should pull INT JUT low when it 
is requesting an interrupt to disable lower priority slots. Cards that 
don’t use IRQ should wire INT IN and INT UUT together so that any higher 
priorty slots can still disable cards in lower priority slots. This 
priorty system fails if there is an empty slot between any two interrupting 
cards. 
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Ihe hardware logic required to generate INT OUT is INT IN anded with the 
active low interrupt signal from the peripheral device.  IRG is INT IN 
anded with the active high interrupt signal from the peripheral device. 


SOFTWARE: 


There are two ways to cause the 65902 to follow the IRQ vector, a logical 
zero on the IRQ pin of the 6502 while the IRQ flag of the processor is 
cleared or executing a BREAK instruction in a program. The first thing 
that the Apple monitor does is determine whether a BREAK or an IRQ has 
occured. In the Auto start ROM, this routine is at SFA4 and in the old 
monitor it's at $FA86. This routine stores the 65302 accumulator at 
location $45 and retrieves the processor status flags. A BREAK will drop 
into the monitor with the address of the BREAK operation code + 2 and a 
dump of the 6502 registers. The Auto-Start ROM has the option of jumping 
to a user's routine after a break. Both monitor ROMs jump to the address 
contained in memory at S3FE and S3FF after an IRQ. 


ee Et b LA = mj E E ET CENT 
IALERRLP-. NA EOL 


The user must have the address of his interrupt handler stored in S$3FE and 
SIFF before the first interrupt is generated. 


IHE ACCEMULATOR 90ES HOT CONTAIN VSLIJ DATA WHEN: IT ES 


EDI II a9 ees ae Sore. 


Ihe accumulator must be restored from location $45 before excuting the 
return from interupt instruction, (RTI). The user must also be careful to 
leave the other rezisters as tney were when an interrupt occured. 


-29 eld: BASIC: 


if tne user is careful to restore all the 6592 registers and not disturb 
BASIC’ s memory locations in the interrupt handling routine, the interrupt 
will be transparent to BASIC. Be very careful of vage ¢ locations. Save 
and restore any information on the stack when you're not sure. 


Sppiesoft and Integer BASIC both use the 5502 stack extensively to keep 
track of GOSUBs and FUR-NEXT loops. This makes it difficult to have an 
interrupt modify BASIC program execution. The easiest way to affect the 
BASIC program is to have the interrupt routine set a flag byte when an 
event occurs and have tne BASIC program PEEK that address and respond if 
anything happened. 


The Applesoft ONERR GOT) statement may be used to modify the execution of 
an Applesoft program when the interrupt occurs. The following machine 
language routine causes an “error” condition in Applesoft. 
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10 POKE 800,162: POKE 801,100: POKE 302,194: PURE 3bd3,..- 
29 POKE 804,104: POKZ 895,76 : POKE 896,233: 2081 997,2«- 
39 POKE 19022,0 : POKZ 1923,8 

49 ONERR GOTO 1900 

58 PRINT "NO INTERRUPT” 
oY SOT) 50 

1000 IF PECK (222) O 100 THEN 250 
109310 PRINT "IXTERRUPT!IÍ! 

1920 RESUME 


The POKEs set the LW vector to generate an error number O) when an 
interrupt occurs. The Applesott onerr routine cau check decimal iocation 
222 and if it doesn’t equal 100 then you have a normal \pplesoft or ous 
error. Treat the IRQ generated error like any other Applesoft error. 
RESUME and the routine on page 32 of the Applesoft reference manual will 
work normally. Please refer to the Tech ote about 5N ERR GOT tor more 


information. 


Tm 


EN Luther To Xe LUS 


Ihe interrupt checking routine in the monitor saves the 55402 accumulator at 
location 323 while it checks [or a oreak. "nfürtundcelv, 205 aiso uses 
location 3-3 as temporary storage while it is oarsing the numeric parts of 
it’s eommands. This can result in range errors or reading the wrong 
record, slot, or drive if an interrupt occurs while it is parsing. There 
is no wav around this problen at this time. The safest way To use 
interrupts with DOS is to disable LRG when doing any disk access. 
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I/O SIGNAL TIMING 
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The I/O strobe signals on the Apple ]{ peripheral connector are decoded from 


the appropriate address lines and combined with the phase one clock. 


This 


is to reduce the TTL circuitry required to build a siuple 1/0 port, 


CLOCK 1 


T/O SELECT 


I/O STROBE 
DEVICE SELECT 


tend 


— — o. u 


à simple 8 bit output port would be a positive edge triggered latch with the 


clock tied to I/O select. 


GND ----------------- | 1 
1/0 STROBE ---------- |11 
i 
DÜ ------------------ | 3 
Dl ------------------ | 4 
D2 ------------------ ar. 
D3 ------------------ | 8 
UA eps eee |13 
D5 ------------------ 114 
D6 ------------------ 117 


| 
| 74LS374 
| 
| 
Je 
5|--- 
6|--- 
9|--- 8 bits of 
12|--- Latched TTI, 
15|--- Output 
lec 
ii nda 


Assumming that this interface is plugged into slot l, any write operation to 


SCÓ90..SCü9F will transfer the data to the output lines. 


[his is a very 


simple interface, so any read to $C090..3CÓ9F will transfer random data to 


the output latch and to the Apple. 
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INDEX TO APPLE /// HARDWARE 


ALPHABETIC LISTING 


Doc Title 

0903 Apple /// and Game Paddles 

GOL Apple /// Memory Diagnostic Display 

$92 Apple /// Video 

999 Errata - Apple /// Owner's Guide 

$94 Joystick Input - Apple II Game Incompatibility 

#95 Joystick Input - Apple II Game Controller Incompatibility 
098 Processor Capabilities 

006 Specifications 

997 System Failure Errors 


NUMERIC LISTING 


Doc Issue Date Previous Date Pages 
091 SEP 25 81 - L 
992 SEP 18 81 - 1 
093 OCT 21 81 - 1 
ADA MAY 24 82 - 1 
9955 MAY 24 82 - l 
$6 JUN 28 82 - L 
097 AUG 25.82 - l 
JOS JAN 11 83 - 2 
999 APR 26 82 SEP 28 81 l 
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APPLE /// MEMORY DIAGNOSTIC DISLPAY 


The Apple /// performs a memory check whenever it^s turned on. Normally 
the display doesn^t stay on the screen long enough to be noticed. However, 
1f you have a memory error you will get an array of periods with an inverse 
"1" to indicate the faulty bit. The memory diagnostic can also be invoked 
by <control> <open-apple> «Reset» and »F6E6G 


Row Bits 


b7 b6 b5.b4 b3 b2 bl bÓ 
b7 b6 b5 b4 b3 b2 bl bf 
b7 b6 b5 b4 b3 b2 bl bf 
b7 b6 b5 b4 b3 b2 bl b 
b7 b6 b5 b4 b3 b2 bl b 
b7 b6 b5 b4 b3 b2 bl bf 
b7 b6 b5 b4 b3 b2 bl b 
b7 b6 b5 b4 b3 b2 bl bf 


Ar row fF ud ~ 


This information can be decoded with the following table to indicate which 
chip needs replacement. 


MAP OF THE MEMORY BOARD 


Board 

Ref Row Chips Row Chips 

D L  b7 b6 b5 b4 b3 b2 bl b 2 b7 b6 b5 b4 b3 b2 bl bf 
C 3  b7 b6 b5 b4 b3 b2 bl b Ó b7 b6 b5 b4 b3 b2 bl b 
B 4 b7 b6 b5 b4 b3 b2 bl b 5 b7 b6 b5 b4 b3 b2 bl bØ 
B 6 b7 b6 b5 b4 b3 b2 bl bf 7? b? b6 b5 bá b3 b2 bl bØ 


For example, if your display looked like this; 


* * * > * * 


you would need to replace the fourth chip from the left end of row “B”. 
This row appears double width because it has 32K RAMs. 
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APPLE /// VIDEO 


The Apple ///”s horizontal sync consists of Susec of sync and 4usec of 
color burst. There are no porches or breezeways. There is a certain 
amount of 3.58 MHz during a video line due to the switching of the pixels. 


I TITLE 


NTSC 


Sa 


VIDEO H SYNC COLOR VIDEO 


p LELLE 


APPLE 
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APPLE /// AND GAME PADDLES 


Standard Apple II 15@K game paddles cannot be used with the Apple III. A 
high impedance potentiometer like the Apple II paddle will not work 
properly connected to an Apple /// port. 


The analog inputs on Port A and Port B of the Apple /// are designed to 
read a voltage between 0 and 2.4 volts and convert it to a number between Ø 
and 255. The schematic on page 82 of the Apple /// Owner^s Guide is drawn 
for a joystick with 5,090 ohm potentiometers. Only the bottom 20% of the 
potentiometer”s range is used. Using the +12 volt power supply will result 
in the most stable readings. 


The following circuit can be used if the entire range of the potentiometer 
is desired. 


+12 or +5 volts 
} 


RS 
iiai must be 2.4 volts at this point. 


Rp (1 - 2K ohms) 


i 
| 
< 
< 
£ 
| 
| 
| 
< 
GC Input ---»$4 
< 
| 
| 
| 


0 volts 


— —— — 


The voltage range at the GC inputs should go from Qv to 2.4v. The value 
of Rs can be calculated for +5 volt systems with this formula: 


Rs = Rp * 2.6 / 2.4 
For +12 volt systems use 


Rs - Rp * 9.6 / 2.4 
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JOYSTICK INPUT - APPLE II GAME INCOMPATIBILITY 


Some machine language games that use the paddle inputs will not work on the 
Apple ///. The hardware for reading the analog inputs is different aud 
some software will not be able to take this into account. 


Also, the joystick ports on the back of the Apple /// are arranged such 
that some games won't work properly in Emulation mode. Most joystick 
oriented games will use PDL (0) and PDL (1) for X-Y control. The ports on 
the Apple /// put these signals on different connectors. Here are the 
Apple II Emulation Mode equivalents of the signals available on ports A and 
B. 


pin Port À Port B 
4 PDL (0) PDL (1) 
5 PBl PB2 
8 PDL (2) PDL (3) 
9 PB3 
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JOYSTICK INPUT - APPLE II GAME CONTROLLER INCOMPATIBILITY 


Apple II paddles will not work when directly wired to the Apple /// 
joystick ports. Please refer to the Apple /// Owner's Guide, pages 128 


through 130 for the proper schematic. The prefered value for the variable 
resistors is 2000 ohms. 
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SPECIFICATIONS 
ELECTRICAL 
AC power 197-132 VAC 6Hz 
DC power at I/O ports 
(128K RAM) 

+5v 8 2.0 amps (Maximum of 1.5 Watts of power per interface card) 

-5v @ 9.2 amps 

-12v @ $.3 amps 

-12v @ $.2 amps 
Power Disapation 

196 Watts 
ENVIRONMENTAL 
Temperature Range 

Operating PC to 45€ (disk media is limited to 35€) 


Storage -35C to 149€ 
Relative ¡iumidity 

205 to 98% non-condensing 
Altitude 

Operating - 1,909 to 15,000 ft 


Non-operating 590,099 ft 
(derate maximum ambient temperature by 1 degree C per 1999 feet 


over 5,909 ft) 


PHYSICAL CHARACTERISTICS 


Height 4.8 in 
Width LI. UB 
Length [5.2 zn 
Weight 26.0 lbs 
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SYSTEM FAILURE ERRORS 


The following table attempts to explain the numbers that are displayed 


following a SYSTEM FAILURE. 
problem. 


A system failure is generally a hardware 
Try recreating the same error with the same software on another 


Apple /// to confirm if it is software or hardware that is causing the 
failure. 


Copying certain protected diskettes will cause an error $06 when the copy 


is booted. 


$91 BADBRK Break instruction from within SOS 
592 BADINTI Interrupting device not found 
S63 BADINT2 Bad zero page allocation 
$84 NMIHANG Unable to lock NMI 
$85 EVQOVFL Event queue overflow 
$96 STKOVFL 6592 stack overflow 
$07 BADSYSCALL DMGR detected invalid request code 
S08 MCTOVFLOW DMGR - too many device handlers 
599 MEM2SML Memory size less than 64K 
SHA VCBERR BFMGR - volume control block not useable 
SPB FCBERR File control block crashed 
SOC ALCERR Allocation blocks invalid 
SOD DIRERR Directory is not correct 
SE TOOLONG Pathname buffer overflow 
SOF BADLU ENUM Invalid buffer number 
$919 BADBUFSIZ Invalid buffer size (=P or >16K) 
BFMGR Block file manager 
DMGR Device Manager 
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PROCESSOR CAPABILITIES 


Industry terminology has divided the world of microprocessors into two 
categories: 8 bit and 16 bit. To determine where the Apple *// syst 
fits, we have to establish the criteria for comparison. The nener or bits 
associated with a processor can be based on many different things: 


“hich memory addressing technique is used? (Addressiag mode) 
¡low much memory can it address with 1 instruction? (Address wiith) 
iow much data does it move in one memory cycle (data width) 
How big are the registers? (register width) 
280 (8 bit) 8088 (8/16 bit) 38080 (16 bit) 
Aadressing mode: Linear Segmented Segmented 
Address width: 16 16 16 
vata width: 8 8 16 
Register width: 16 16 16 


So beyond some improvements to the instruction sets, the primary difterence 
between tre 3835 and the 288 is the change of technique ia adáressing 
memory. Insiead of being restricted to 64K you can now address up to 1024K 
using a sesmented (or extended) memory access. This technique allows you to 
use a lb dit address as an offset from a base location. In the Apple ///, 
Apple toux the sane technique and applied it to the 0502 processor (using 
LSI surrounding the 6502B) to produce a custom designed processor that uses 
a segmented technique to effectively address more than 64K of memcry (up to 
512K in the architecture). Thus the statement that the Apple /// uses 
¿b=bit technoinzv to access large memory effectively. 


6592 (8 bit) Apple EE E DLE 
Addressing mode: Linear 3jezzented 
¿rss width: 16 15 
pat widen: 5 ^ 
Register width: ib A 


Although similar in concept, there are many differences in implementation 
between the two architectures producing a wide viaria 
performance results. The most obvious of these is the 


à 

CPU-based sezment registers, and the Apple ¿// has .28 menory-based (zero 

page) segment registers. in general, though, the Appie arecessor and 

the 8083 caa per?orm with approximately the same speed in most applications. 
(Continued) 
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LXAMPLE: 


VisiCalc is a program that runs on both machines. Try the following example 
(a multiplication table) on both the Apple /// and the IBM-PC versions. 


4 GY 

1 

>B1:+A1+1 

>A2:+Al+L 

>B2:+B1*A2 

>B1:/R.B2:C1.Hl:RRN 

2A2:/R.H2:A3.A200: RNRNRNRNRNRNRNR (7 NR^s) 


Now type ! to recalculate and time the results. 


On the IBM-PC the recalculation will run in about 22 seconds. On the 

Apple /// it will run in about 14, AND if you turn off the screen first (by 
holding down CONTROL and pressing 5 on the numeric keypad) it will run in 11 
seconds, twice as fast. 


So how many bits does the Apple /// have? 


Apple has in general stopped short of claiming that the Apple /// is a full 
16-bit computer because we have always felt that the data bus width is the 
primary measure of the processor, because this data width can have a large 
impact on the speed of an application. Thus our statement that the 

Apple /// has the addressibility of a 16-bit processor with the data width 
of an 8-bit. (As does the 8088.) Putting this into marketing tongue, we 
have "The Apple /// has the capabilities of a l6-bit processor with the 


economy of an 8-bit.” 
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Page 8f 
Pin number 9 of port A is really SW3. 
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INDEX TO APPLE /// EMULATION MODE 


ALPHABETIC LISTING 


Doc Title 

092 Apple /// and Apple Plot 

903 Apple /// Disk Drives and Emulation Mode 

095 Comparison to Apple ][ Hardware 

94 Controlling the Most Significant Bit of the Built in Port 
991 Printing from Emulation Mode 


NUMERIC LISTING 


Doc Issue Date Previous Date Pages 
091 SEP 39 81 - 1 
092 SEP 25 81 - 1 
903 APR 26 82 SEP 3% 81 1 
804 JUN 25 82 - 2 
$05 JAN 12 83 = L3 
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PRINTING FROM EMULATION MODE 


The first version of Apple II emulation mode for the Apple /// simulates a 
Communications card in slot 7 that uses the port C RS-232 hardware. This 
simulation doesn’t drive printers very well. The machine language routine 
below will properly drive any printer from emulation mode that can be 
driven from Business Basic. 


CALL 768 will initialize the routine and connect it to either Basic through 
DOS. PRINT CHRS(4);"PR#®" will return output to the screen. 


The replacement value for x, y, and z are from the Apple /// Standard 
Device Drivers Manual on pages 82 and 83: 


x = the low digit from the table on page 83 
y - the high digit from the table on page 83 
z = the low digit from the table on page 82 


300:A9 19 LDA #519 ;SET UP I/O VECTORS 
302:85 36 STA $36 

304:49 93 LDA #593 

306:85 37 STA $37 

308:20 EA 63 JSR SQ3EA 

39B:8D Fl CÓ STA $CØF1 ;RESET ACIA 
30E:A9 2B LDA #$2B :SxB, odd parity 
310:8D F2 CÓ STA $CØF2 

313:49 28 LDA #528 :Syz, 7 bits, 1200 baud 
315:8D F3 CÓ STA SCOF3 

318:660 RTS 

319:48 ENTER PHA 

31A:AD Fl CÓ LOOP LDA SCÓFi1 

31D:49 16 EOR #$1¢ 

31F:29 79 AND #$79 

321:DØ F7 BNE LOOP 

323:68 PLA 

324:8D FØ CÓ STA SCOFÓ 

327:C9 8D CMP #$8D 

329:D¢ 97 BNE OUT 

32B:48 PHA 

32C:A9 8A LDA #S8A 

32bE:29 17 $3 JSR ENTER 

331:68 PLA 

332:60 QUT RTS 
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APPLE /// DISK DRIVES AND EMULATION MODE 


The Apple II emulation mode on the Apple /// is configured so that the 
internal drive looks like Slot 6, Drive 1 and the first external drive 


looks like Slot 6, Drive 2. Emulation mode can't access the third nor 
the fourth external drive. 
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APPLE /// DISK DRIVES AND EMULATION MODE 


The Apple II emulation mode on the Apple /// is configured so that the 


internal drive looks like Slot 6, Drive 1 and the first external drive 
looks like Slot 6, Drive 2. Emulation mode can’t access the third or 
the fourth external drive. 
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CONTROLLING THE MOST SIGNIFICANT BLT OF THE BUILT IN RS-232 PORT 


INTRODUCTION: 


This driver allows the user to control bit 8 of the built-in RS-232 port in 
Emulation Mode. Bit 8 is used by some printers to select expanded or 
normal print mode or to enable alternate or graphics character sets. DOS 
3.2 or DOS 3.3 is required to use this routine. Both the Serial Card 
Emulation and the Communications Card Emulation are supported. 


SOFTWARE ENTRY 


Boot a DUS diskette and enter the monitor with CALL -155 and type 


3B@:A9 07 
:20 95 FE 
:A9 80 
:20 ED FD 
9.03 
:35 36 
:A9 3 
2959-37 
:4C EA 03 
:29 7F 
:ØD CD 83 
401 CT 
:89 


To check your typing, type 
3BOL 


and compare your listing to the one below. 


0389- . A9 $7 LDA #597 
03B2- 298 95 FE JSR  SFE9S 
03B5- a9 BÉ LDA #S$8¢ 
03B7- 28 ED FD JSR  SFDED 
03BA- A9 C5 LDA  %SC5 
03BC- 85 36 STA $36 

0 3BE- A9 p3 LDA #563 
6ó3có- 85 37 STA S37 
03C2- | 4C EA 43 JMP | SQ3EA 
03C5- 29 7F AND #S7F 


03C7- AD CD $3 ORA s$3CD 
03CA- 4C d7 C7 JMP $C767 
93cD- 80 272 

Now return to Basic with 3DG 


(Continued) 
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SAVING THE PROGRAM 10 DISK: 
Save the driver to disk by typing 

BSAVE SERIAL DRIVER, AS3BÓ, LSLE 
USING LAE PRESTER 


The driver should be in memory before you want to use the printer. You 
must load the driver and initialize the interface. From command mode type 


BLOAD SERIAL DRIVER 
CALL 944 


This may be done from a program by entering 
19 PRINT DS;"BLOAD SERIAL DRIVER" : CALL 944 
assuning that DS contains a Control-D. 
If vou want to switch back to the video monitor for output type 
PRF% 
or in a progran enter 
2Ø PRINT DS; "PRD" 
Then to reconnect the printer, all that is required is 
CALL 954 
or trou a program 


34) CALL 954 
SETTING THE PRINT MODES: 


Io set normal print mode POKE 973,% 
To set expanded print mode POKE 973,128 
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COMPARISON TG APPLE II HARDWARE 


This section covers the differences between the Apple II hardware and the 
emulation mode found on the Apple ///. To use this information, you need to 
have a copy of the Apple II Reference manual. The following pages represent 
the DIFFERENCES which would exist if the manual were written specifically 
for Apple /// emulation mode. Titles and figure numbers are such that they 
correspond to the existing manual. 


THE KEYBOARD 


The Apple 11 Emulation Keyboard 
Number of Keys: 75 
Coding: Upper Case ASCII 


Number of Codes: 192 (All ASCII except lower case alpha) 
Output: 2 Ports À — Seven bits, plus strobe 
B - Modifier keys 
Rollover: 2 key 


Special keys: CONTROL 
ESCAPE 
RESET 
TAB 


ALPHA LOCK 
<left arrow»? 
<right arrow? 
<up arrow? 
<down arrow? 
<open apple? 
<closed apple» 


READING THE KEYBOARD 


Keyboard data port A and Clear Keyboard Strobe are identical to the Apple II 
keyboard. Keyboard port B is new and it allows reading the special keys on 
on the keyboard. 


Keyboard port B is organized as : 


(Continued) 
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| spcL | KYBD | AS | AO | ALK | CTRL | SHIFT | ANYKY | 
| | 


SPOL l - A key is pressed on the numeric pad, cursor keys, 
space bar, TAB, ESCAPE, RETURN 
Ø - The last key pressed was not one of the above 


keys. 
KYBD ] - "ON" light of the keyboard active 
Ø - "ON" light burned out, or Keyboard not connected 
AS l - Solid Apple key not pressed with an ASCII key 


since a Clear Keyboard Strobe 
Ø - Solid Apple key pressed with an ASCII key 





AO l - Open Apple key not pressed now 
Ø — Open Apple key pressed now 
ALK 1 - APLHA LOCK key up 
Ø - ALPHA LOCK key down 
CTRL 1 - CONTROL key not pressed now 
Ø - CONTROL key pressed now 
SHIFT l - SHIFT key pressed with an ASCII character 
Ø - SHIFT key not pressed with last ASCII character 
or Clear Keyboard Strobe 
ANYKY 1 - ASCII character key is pressed now 


Ø - No ASCII character key is pressed now 


The RESET button is located on the upper edge of the keyboard between the 
"Aj" key and the "7" on the numeric pad. In Apple II emulation mode it 
generates an NMI (Non-Maskable Interrupt) to the 6502 microprocessor. This 
is not the same as a RESET to the microprocessor chip which actually powers 
the chip down. Thus, illegal operation codes, which cause the micro to 
hang, cannot be escaped from through the use of this key alone. However, 
the RESET pin (31) on the slots 1 through 4 will go low for the duration of 


the button pressing. 


In emulation mode the NMI will normally jump to the RESET code which is in 


the AUTOSTART monitor. Thus, in most cases there is no difference between 
an Apple ][ and emulation mode. 


(Continued) 
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Pressing CONTROL and RESET together will cause a true RESET to the 6592 and 
the computer will return to Apple /// native mode with the disk attempting 
to boot an Apple /// disk. 


The REPT key is not on the keyboard as each ASCII key has auto repeat which 


repeats approximately Il times a second. The repeat speed can be raised to 
3% characters a second by pressing the Solid Apple key after pressing the 


character key. 
High speed repeat is also available on the cursor keys by pressing the key 
firmly. 


READING THE KEYBOARD 


Table 1 : Keyboard Special Locations 


Location: 
dex Decimal Description 
SCYPY 49152  -16384 Keyboard Port A 
sc008 49160 -16370 Keyboard Port B 
Scal 49168 -16368 Clear Keyboard Strobe 


Table 2: Keys and their Associated ASCII Codes (Bit 7 always set) 


The values for the main keyboard are in addition to the information on port 
B. The keypad will read the values indicated on the table with the SPCL bit 
on port B set to one. 


Xey Alone CONTROL SHIFT Both Keypad 
<space> Saf SAG SAQ SA 
ESCAPE 598 398 $9B S9B 
La SBl SBl SAI SAl SBl 
2d S B2 S B2 sch sag 3B2 
3# S B3 S B3 SA) 343 $B3 
4$ S B4 SB4 SA4 sas SB4 
25 SB5 $85 SA5 $A5 SB} 
6^ SB6 S B6 SOE 39E S BÓ 
7à SB? SB/ 546 3À6 SB7 
8* SB8 s B8 SAA SAA SB8 
9( SB9 SB9 SAS SA8 SB9 
4) S B9 $ BQ SAI SA9 $89 
2m SAD SAU SDF S9F SAD 
=+ S BD S bL SAB SAB 
\ | SDC sg SFC SFF 
TAB 589 S39 589 589 
u SDB $98 SFB $9B 
(Continued) 
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1} SDD S9D SFD S9D 
s SA7 SA7 SA2 SA2 
RETURN 58D 58D 58D S8D 58D (ENTER) 
y < SAC SAC S BC SBC 
> SAE SAE SBE SBE SAE 
/? SAF SAF SBF SBF 
<left arrow»? $838 $88 $88 $88 
<right arrow? $95 $95 $95 $95 
<up arrow? S8B $8B $8B $88 
<down arrow» S8A S8A S8A S8A 
š SAE SAE SAE SAE 
= SAD SAD SAD SAD 
ENTER $8D $8D $8D 58D 
A SC l $81 SC l $81 
B SC2 582 S62 $82 
C SC3 $83 $C3 $83 
D SC4 S84 SC4 S84 
E SC5 $85 SC5 $85 
F BCD S86 SC6 $86 
G SC $87 SC7 $87 
H SCB8 $88 $C8 S88 
I SC9 $89 SC9 $89 
J SCA $8A SCA S8A 
K SCB SaB SCB $8B 
L SCC $8€ SCC $8€ 
M SCD $8D SCD S8D 
N SCE S8E SCE S8E 
O SCF S8F SCF S8F 
E SDP $99 SDP $90 
Q SDL S91 $D1 S91 
R SD2 $92 $D2 $92 
S SD3 $93 SD3 $93 
T SD4 $94 SD4 $94 
U SDS $95 SD5 $95 
V SD6 $96 SD6 $96 
W SD7 $97 $D7 $97 
X $D8 $98 $D8 $98 
Y 5D9 $99 $D9 $99 
Z SDA $9A SDA F9A 


THE VIDEO CONNECTOR 


The Apple /// has several connections for video output. 
The B/W VIDEO connector is located in the center of the back connector panel 


between the COLOR VIDEO and AUDIO connectors. It provides black and white 
positive composite synchronization video signal. This can be plugged 
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directly into most black and white monitors with an input impedance of 75 
ohms. An RCA-type male to male connection cable is provided for this 
connection. 


The COLOR VIDEO CONNECTOR provides outputs for NTSC compatible black and 
white, NTSC color, and RGB. A complete explanation of this connector is in 
the Apple /// Owner's Manual. 


THE HIGH-RESOLUTION GRAPHICS (HI-RES) MODE 


The Apple II emulation mode high resolution graphics are identical to the 
Apple II except some combinations of colors on the right edge of the screen 
will cause the left edge pixels to blink. This is normal, although 
distracting. 


THE LOW-RESOLUTION GRAPHICS (LO-RES) MODE 


ihe Apple II emulation mode low resolution graphics have two slight 
improvements over the Apple ]{. First, in black and white, the Apple /// 
will produce 16 levels of gray instead of 3 in the Apple j[. Secondly, the 
Apple jj color blocks vary in size while the Apple /// doesn't. 


THE SPEAKER 


The speaker function is identical to the Apple II with the following 
additional features. 


A reference to location 49216 (or the equivalent addresses -16336 or 
hexadecimal SCÓ49) will cause a f.1 second 1 KHz tone to be produced which 
is similar to the sound the AUTOSTART monitor makes when the BELL character 
is sent to the screen. The advantage to this is 9.1 seconds of CPU time is 
returned to the user, since only 4 microsecond is required to start the BELL 
sound. 


The AUDIO connector at the back of the Apple /// provides the same signal as 
the speaker. When you insert a miniature phone-tip plug into this jack, the 
Apple’s internal speaker is silenced; if there is an amplifier or other 
device properly connected to the plug, then that device will receive all 
audio signals generated by the Apple. The signal is a 9.5 volt peak-to-peak 
audio signal on its tip aud signal ground on its ring. 


THE CASSETIE INTERFACE 
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The cassette interface is completely eliminated on the Apple ///. 


References to the cassette output port at 49184 (or the equivalent -16352 of 
hexadecimal $C@2@) will cause pin 39 of the I/O slots to go low for a 
microsecond. This is for use by Apple /// native mode peripherals to 
deselect the $C899 ROM address space. 


Reading the cassette input port at 49248 (or the equivalents, -16288 or 
hexadecimal $C#6@) will read joystick switch 9 into bit 7. 


THE GAME I/O CONNECTOR 


The Game I/O connector does not exist in the Apple ///. 


ANNUNCIATOR OUTPUTS 


The annunciator outputs do not exist in the Apple ///. These locations 


address the A/D convertors to read the joysticks. 

ONE-BIT INPUTS 

The one-bit inputs are used to read the switches ou the joysticks. There 
are three one-bit inputs. They have the addresses 49248 through 49251 
(216288 through 16285 or hexadecimal $C69 through $C063 respectively). 
The input switches are read in bit 7 of their data bytes. Port B reads 


input switches l and 3. Port A reads input switches ® and 2. 


Table 19: Input / Output Special Locations 


Function Address: 
Decimal Hex Read/Write 

Speaker 49200 -16336 SCB39 R/W 
Beep 49216  -10328 scp4P R/W 
Deselect $C8609 

on Apple /// 

peripherals 

(pin 39 on card) 49184 -16352 SC929 R/W 
Joystick switch Ø 49248 -16288 S$C669 R(bit 7) 
Joystick switch l 49249 -16287 sc@6l R( bit 7) 
Joystick switch 2 49258 -16286 $CP62 R(bit 7) 
Joystick switch 3 49251 -16285 SCÓ063 R(bit 7) 

ANALOG INPUTS 
(Continued) 
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The system has two joystick ports with provisions for two A/D inputs each. 
Port A reads A/D inputs 3 and 4 while Port B reads inputs l and 2. 


To read the A/D ínputs, the software must select the desired input and 
charge the ramp capacitor for at least 500 microseconds. Then the ramp is 
started and the time measured until the A/D timeout goes low. The discharge 
time is proportional to the ínput voltage. Dis-assemble the emulation 
monitor starting at FBlE for an example. 


Table 9: A/D Input Selection 


A/D2  A/D1  A/Df Input 
9 0 $ Ground 
Y p 1 Joystick, Port B, X axis 
L 1 0 Joystick, Port B, Y axis 
L 1 i Joystick, Port A, X axis 
L 9 Joystick, Port A, Y axis 
l Y 1 Clock Battery 
1 1 d No connection 
l 1 1 Reference Voltage 
A/D Select 0 49249 -16296 $C#58 R/W 
A/D Select f 49241 -16295 $C$59 R/W 
A/D Select 1 49246 -16290  SCÓ5E R/W 
A/D Select 1 49247 -16289 $CØ5F R/W 
A/D Select 2 49242  -16294 SCO5A R/W 
A/D Select 2 49243 -16293 3SC5B R/W 
A/D Ramp charge 49244 -16292 SC05C R/W 
A/D Start timeout 49245 -16291 SCP5D R/W 
A/D Timeout 49254  -16282 $cC@66 R(bit 7) 
Clock millisecond 
counter (SN) 49264 -16272  SC907Ó R(bits 7-4) 


STROBE OUTPUT 


The strobe output has been replaced by 9.1 second 1 Khz tone from the 


speaker. 


AUTOSTART ROM / MONITOR ROM 
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The Apple II emulation diskette comes with a modified version of the 
Autostart ROM. This is a write protected RAM image which is loaded at Apple 
II emulation boot time. 


INPUT / OUTPUT STRUCTURE 


BUILT-IN 1/0 
DATA INPUTS 


ihe keyboard is read through two ports which províde the complete state of 
the Apple /// keyboard. Port A is identical in both location and content to 
the Keyboard Data Input of the Apple il. 


FLAG INPUTS 


The method of reading the flags is the same, though some flags, such as the 
cassette input, are not present. 


STROBE OUTPUTS 


The Utility strobe doesn't exist in emulation mode and the Game strobe is in 
a different location. 
TOGGLE SWITCHES 


Only the speaker toggle is present. 


SOFT SWITCHES 


A/D selection locations are soft switches which produce a 3 bit value to 
determine which device is to be attached to the analog input. The 
Annunciator outputs are not present. 


Table 22: Built-In I/O Locations 


— ey — 
-p — — «D — — —À — ee  — mn —À E — — E — — 
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SCÓ99 Keyboard Port A Input 


SC098 Keyboard Port B Input 
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50910 Clear Keyboard Strobe 
$C920 Deselect all expansion 1/0 space (pin 39) for Apple /// cards 
SCÓ3À Speaker Toggle (lus) pulse 
$U940 Speaker Beep (1 KHz for #.1 second) 
50058 | gr — | tx | nomix {| mix | pri | sec | lores | hires | 

| | | | | | | 

30958 | A/D BÀ | A/D Ø | A7D 2 | A/D 2 | A/D CHG| A/D STI A/D L | A/D 1 | 
sce | swe | SW1l | sw2 |sw3 | IRQ2 | IRQ 1 | A/D TM] MUX1 | 
5c9070 Clock millisecond output (SN) 
$C099-$C29F Slot I Device Select (pin 41) goes low during CIM 
SCHAP-SCHAF Slot 2 bevice Select (pin 41) goes low during ClM 
SCOBO-SCÓBF Slot 3 Device Select (pin 41) goes low during ClM 
SCOCO-SCOCF Slot 4 Device Select (pin 41) goes low during CIM 
SCOEO-SCUEF Disk Drive Hardware Addresses 
SUDEP ACIA Receive/Transmit Data register 
SCOFL ACIA Status register 
SCOF2Z ACIA Command register 
SCQF3 ACIA Control register 
$Clg-SCIlFF Slot 1 I/O Select (Pin 1) goes low during C1M low 
SC209-SC2FF Slot 2 1/0 Select (Pin 1) goes low during CLM low 
SCIOP-SCIFE Slot 3 1/0 Select (Pin 1) goes low during CIM low 
SC4PP-3C4 EE Slot 4 I/O Select (Pin 1) goes low during CIM low 


PERIPHERAL BOARD I/O 
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Ihe Apple /// implements only slots 1 through 4. Slot 6 is always a disk 
interface card and slots 5 and 7 contain either a SERIAL or COMMUNICATIONS 
card. Slot Ø scratchpad RAM exists but no provision is made to put a 
LANGUAGE card or FIRMWARE card into the system. Thus the RAM is limited to 
+3K with a 12K ROM chosen at boot time. 


PERIPHERAL CAKD I/O SPACE 


Slot 6 I/O space SCÓEU-SCÓEF contains the hardware for the disk interface. 
Slot 7 1/0 space SCÓFÓ-SCÓÉF3 contains the addresses for the onboard ACIA. 


F-RIPHERAL CARD ROM SPACE 

Slot 5 and slot 7 contain code which is functionally equivalent to the 
COMMUNICATIONS or SERIAL card for the Apple II. They differ in that they 
-se the built-in ACIA. For a more complete explanation, see "SERIAL AND 
COMMUNICATION CARD EMULATION ". 


Slot 6 contains a copy of the Apple II 16 sector Boot PROM. 


HARDWARE CONFIGURATION 


1HE MIC, ROPROCESSOR 


The oniv difference is the 6592B microprocessor used in the Apple ///. ne 
3 designation indicates it can use a faster clock frequency, but emulation 
mode uses tae standard 1.023 MHz clock. 


N TLMLNG 


‚sten timing is identical. 


DJwEKR SUPPLY 


Input voltage: 199 VAC to 125 VAC, 50/69 Hz 100W max. 
200 VAC to 259 VAC, 50,69 Hz 109W max. 


Supply voltages: +5.8 VDC -2%/+3% 
+11.8 VDC +6%/-6% 
-5.0 VDC +6%/-1P% 
-12.0 VDC +19%/-19% 
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Power Consumption: 199 W max. 


Full load power output: +12V: 2.54 
+ 5V: 4.894 
- 5V: (0.254 
-12V: Q.30A 


ROM MEMORY 

The Applesoft, Integer Basic, and Autostart Monitor "ROMS" are actually 
write protected RAMs in the Apple ///. When the Emulation mode disk is 
booted, it loads RAM memory with an image of a set of ROMs. Whichever 
language is selected when the Apple II disk is booted is loaded into the 
address space (SDPBB-SFFFF) and write protected. 

RAM MEMORY 


In Emulation mode there is always 48K of RAM. It is addressed $0999 to 
SBFFF. There is no provision for a slot 0 Language or Firmware card. 
"USER 1" JUMPER 


There is no "User 1” jumper in the Apple ///. 


POWER CONNECTOR 


The power connector is different but is not user accessibie. 


SPEAKER 


The speaker is identical to the Apple II. 


PERIPHERAL CONNECTORS 


The Apple II emulation redefines a few of the pins on the connector and adds 
several new ones. 


The most significant difference is that interrupts will not be sent to the 


6502 from the slots. In fact the IRQ (pin 38) is an input to the card so 
the card can't even determine if an interrupt is occurring. Thus Emulation 
mode runs without interrupts, period. 
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The RES (pin 31) is an output to the card and goes low when the RESET key is 
pressed on the keyboard. However, the microprocessor is actually performing 
an NMI, not a RESET. 


Figure 21. Peripheral Connector Pinout 








GND 26 25 +5V 
DMAOK 27 24 NOT USED BUT BUSSED TO ALL SLOTS 
DMAT 28 23 NOT USED BUT BUSSED TO ALL SLOTS 
IONMI 29 22 TSADE (Open collector) 
IRQ 39 21 RDY (Open collector) 
IORES 31 29 I/O STROBE 
INH 32 19 PHÓ 
-12V 33 18 R/W 
-5V 34 17 A15 
SYNC 35 16 Al4 
C7M 36 15 A13 
Q3 37 14 A12 
CIM 38 13 All 
IOCLR 39 12 Ald 
C1M 4g 11 A9 
DEV SEL 41 1g AB 
D7 42 9 A7 
D6 43 8 AR 
D5 44 7 AS 
D4 45 6 A4 
D3 46 5 A3 
(Continued) 
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Pin: 


18 


19 


29 


22 


D2 
Dl 


DØ 


Table 33: 


Name: 


1/0 SELECT 


AD-A15 


R/W 


Pug 


I/O STROBE 





TSADB 
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47 4 A2 
48 3 Al 
49 2 Ad 
50 1 1/0 SELECT 


Peripheral Connector Signal Description 


Description: 


This line, aormally high, will become low when the 
microprocessor references page SCn, where n is the 
individual slot number. This signal becomes active 


during PH (nominally SPPns) and will drive 12 LSTTL 
loads. 


The buffered address bus. The address on these 
lines becomes valid within 3/%ns after the beginning 


of CIM and remains valid through PHP. These lines 


will each drive 8 LSTTL loads. 


Buffered Read/Write signal. This becomes valid 
at the same time the address bus does, and goes 
high during a read cycle and low during a write. 
This line can drive up to lØ LSTTL loads. 


A l MHz signal which is identical to CIM. This 
line will drive 5 LSTTL inputs. 


This line will go low during CLM when the address 
bus contains an address between $3C099 and SCFFF. 
This line will drive 12 LSTTL loads. 


The 5527s RDY input. This line should change 
only during C1M, and when low will halt the 
microprocessor on the next read cycle. This line 
has a LK ohm pullup to +5V. This line should be 
driven [rom an open collector output. 


A low on this line from the peripheral will cause 
the address bus to tri-state for Direct Memory 
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23 
24 


25 


26 


Li 


28 


29 


39 


sl 


32 


33 


34 


35 


+5V 


GND 


DMAOK 


DMAT 


IONMI 


IRQ 





IORES 


=12V 


SYNC 
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Access (DMA) applications. This has a l K ohm 
resistor pullup to +5V. This should be driven from 
an open collector output. 


Not used in an Apple ///. 
Not used in an Apple ///. 


Positive S-volt supply, 2.9 amps total for all 
peripheral boards together (but note a limit of 
1.5 Watts per board). 


System circuit ground. Ø volt line from power 
supply. Do not use for shield ground. 


Acknowledge signal to the peripheral following its 


request for the special Direct Memory Access (DMA ) 
mode.  Informs the peripheral that the DMA can now 


proceed. 


Direct Memory Access (DMA) interrupt. Requests the 
Apple /// DMA mode. Has a 1 K ohm pullup to +5. 
This should be driven from an open collector output. 


Input/Output Non-Maskable Interrupt. This is 
equivalent to the [ORES (pin 31) line as it will 
execute the same code ín the Autostart ROM. This 
line should be driven by an open collector output. 


This line is ignored in Apple II emulation mode. It 
should be driven by a TTL output. 


Input/Output Reset signal used to reset the 
peripheral devices. Pulled low by a power on or 
RESET key. This line will drive 12 LSTTL loads. 


Inhibit line. When a device pulls this line low, 
all system memory is disabled. This line has al K 
ohm pullup resistor to +5V and should be driven from 


an open collector output. 


Negative 12 volt supply, 2ddmA total for all 
peripheral boards together. 


Negative 5 volt supply, 2000A total for all 
peripheral boards together. 


The 65902 opcode synchronization signal. Can be used 
for external bus control signals. Will drive 19 
LSTTL loads. 


(Continued) 


Copyright (C) 1983 by Apple Computer, Inc. 


—P 


— — V — —A y —À o m — — A —— — — — —À —- A Re — —— —À ooo o um cuam o c A c —— e a R e e r e m ooo Ee eee A 


Lssued 


Lé wat 83 


-— o ss he be AW o r r mo m M m. ee ee eee 


36 


3% 


38 


39 


49 


E a 
Si 


42-49 


70 


IOCLR 


CIM 


DEVICE SELECT 


D/-Dà 
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Seven “iz high frequency clock. Will drive 19 LSTTL 
loads. 


A 2MHz (non-symetrical) general purpose timing 
signal. Q3 will drive if LSTTL inputs. 


Complement of CLM clock. This will drive 12 LSTTL 
loads. 


Provides the $C8ØØ space disable function directly 
without address decoding (SCFFF is used for Apple II 
peripherals. It is addressed from $C@2x. This line 
will drive 12 LSTTL loads. 


Phase CLM clock. This is the same as the micro- 
processor’s | MHz clock. This will drive 12 LSTTL 
loads. 


This line becomes active (low) on each peripheral 
connector when the address bus is holding address 
between SCnÜ and SCQnF where n is the slot number 
plus 38. This line will drive 12 LSTTL loads. 


Ihe 8-bit system data bus. During a write cycle, 
data is set up by the 65902 less than 3ßßns after the 


beginning of CiM. During a read cycle the 6592 
expects data to be ready no less than 19@ns before 
the end of 


CiM. These lines will drive 8 LSTTL inputs. 


Positive i2 volt supply, 30PmA total for all 
peripheral boards together. 
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INTERFACING THE APPLE /// TO SERIAL PRINTERS 


The Apple /// is a terminal type RS-232 device as are most serial printers. 
This means that some of the wires in the cable between the Apple /// and 
the printer need to be changed for proper communications and handshaking to 
occur. There is a short cable adapter available from your Apple dealer for 
connection to a Qume Sprint 5 printer (Apple Part Number B3MPD1O). 

However, other printers may have other requirements. 


The Table 1 and Table 2 on the following pages give the cable adapter 
wiring diagrams for some popular printers. Scan Table L until you find the 
brand and model of your printer. The number in the "DIAGRAM" column 
indicates which wiring diagram in Table 2 you need. The "NOTES" column in 
Table 1 gives additional information for proper interfacing. Wire up the 
adapter as shown and install it betweea the Apple /// and the printer. 


Included below is the specification for the Apple /// RS-232 interface in 
case your printer isn't mentioned. 


Pin Name Function Notes 
1 GND Frame ground 
z TxD Transmit Data Data output to printer 
3 RxD Recieve Data Not used by printer driver 
4 “RTS Request To Send Handshake output to printer 
2 2CLS Clear To Send Do not use 
6 =DSR Data Set Ready Handshake input from printer 
7 GND Signal ground 
8 =DCD Data Carrier Detect Handshake input from printer 
20 -DTR Data Terminal Ready Handshake output to printer 
The "-" before the name of a signal indicates that it is a negative true 


signal. These signals are considered active if the signal is above +3 
volts at the RS-232 connector and inactive if less than -3 volts. 


Use of -CTS is discouraged because it directly controls the Apple's data 
transmitter and may stop transmission in the middle of a character. The 
Apple /// printer driver sets up -RTS and -DTR to alert the printer and 
checks both -DSR and -DCD for printer ready information before transmitting 
any characters. All handshake input lines are pulled to an enabled 
condition on the Apple /// if the printer doesn't use them. 


The first version of Apple II Emulation mode that was shipped did not check 
-DSR or -DCD before transmitting. 


(Continued) 
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TABLE 1 
PRINTER 


ANADEX DP-9508 


DP-95$1 
ANDERSON JACOBSON 832 
833 
841 


AXIOM EX-8@1 
EX-829 


CENTRONICS 737 


C- ITOH 
C-ITUlH Fl 


COMPRIAT 912 


DEC LA34 
LAL29 


DIABLO 639 

DPSON VX-76 
MX—-80 
M4X-109 

AEATHKIT H-14 


LOS 


£^ 4> 15 a 
N OO $ te to IV 
Ss ur n1 


Ur 4 


5519 / 7719 
5519 7 7715 
5529 / 7729 
5525 4 1/25 


NEC 


APPLE TECH NOLES 


DIAGRAM NOTES 
5 CHECK PARITY, BAUD, STOP BITS, ETC 
5 CHECK PARITY, BAUD, STOP BITS, ETC 
A 
A 
A INSTALL JUMPER AT LOCATION “F” 
8 
8 
3 
8 CHECK PRINTER OPTION JUMPERS 
A USE AT 1209 BAUD 
8 CHECK PRINTER OPTION JUMPERS 
8 SET DRIVER TO 300 BAUD 
A 
3 
2 USE AT 96909 BAUD 
2 USE AT 96900 BAUD 
8 
l 
7 
7 
Pi 
7 
7 
7 
6 Set Switches | 
6 Set Switches | 
6 Set Switches | 
6 Set Switches | 
Dip Switch SWl: 12345678 | 
1001011 1=0N | 
Q-OFF | 
Set Driver to 7 bits, Mark Parity | 
(Continued) 
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OKIDATA 824 2 Set switches 
83A 2 Set switches 


Dip Switches: 87654321 
Front 190190099  1-20N 
Back 181811 Ø=0FF 
Jumper Blocks: Position À 


QUME SPRINT 5 A 
TELETYPE 43 8 
TI 819 3 


TABLE 2 - Cabling Diagrams 


1 Apple /// Printer 
| ------------- 1 
2 ewa nn 3 
6 ------------- 4 
7 ------------- 7 

2 Apple /// Printer 
ee 1 
2 RR 3 
Benni LL 
] == 7 

3 Apple /// Printer 
A A I 
ies 3 
ee 6&8 
i e.a e un 11 
sa 7 

4 Apple /// Printer 
LA - 1 
zZ een 3 
6 ------------ 14 
7 ------------- 7 

5 Apple /// Printer 
Dee 1 
Degen 3 
een 19 
nee 7 

(Continued) 
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6% Apple /// Printer 
eee 1 
2 nn 3 
TEE 5 
-— 19 
Lo 7 
29 -------- 6 & 8 
7. Apple /// Printer 
De ne 3 
6 weer a 20 
7 ------------- 7 
8 Apple /// Printer 
| o----—--------- 1 
2 ------+------- 3 
6 ------------ 29 
7 mo 7 
Ae APPLE SUPPLIED CABLE 
APPLE PART # A3MPP19 
Apple /// Printer 
l ---—----------- l 
I nn 7 
2 Beeren 3 
I en en 2 
4 7 I men 8 
H HE 4&5 
6 ------------ 20 
20 ------------ 6 
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INTERRUPTS AND RESET ON THE APPLE /// PERIPHERAL SLOTS 


The Apple /// slots can not respond to IRQ or RESET from the peripheral 
cards in emulation mode. There is no way around it because the hardware is 
different.  NMI is not on the same pin as in the Apple II and will act like 


RESET on the Apple II. 


Seance 
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PROBLEMS WITH THE APPLE II PARALLEL PRINTER INTERFACE 


There is a slight timing problem when the Apple II Parallel Printer 
Interface is used in an Apple ///. The best way to solve this is to get a 
Universal Parallel Interface which will work in both Apple /// mode and 
Apple II emulation mode. The Apple II Parallel Printer Interface can be 
made to work with the addition of a 0.901 microfarad capacitor between pins 
4 and 7 of chip B2, a /4LS74. 
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USING THE SUPER SERIAL CARD IN THE APPLE PH 


The Super Serial Card can be used in the Apple /// with the appropriate 
driver. But, since the Apple /// is an interrupt driven system, switches 
S2—6 and S2-7 must be ON to enable interrupts from the card. The Apple /// 
will hang when the driver is opened if this is not done. 
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.RS232 - NUMBER OF STOP BITS 


There is no way to control the number of stop bits sent out by the .RS232 
driver. It will send out one stop bit except at 11% baud when it sends out 
two. 
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CONSOLE DRIVER - CHARACTER SETS 


The console driver has a control call that will load up to eight new 
character definitions for the video display. Here is a Pascal prograu that 
will change one character. 


PROGRAM SWAP; 
VAR 
UNITNUM : INTEGER; 


REQUESTCODE : PACKED RECORD 


CHANNEL © Beals 
STAT OR CTRL t Waali 
REQUEST NUM :0,,255:5 
RESERVED ::0..63; 
END; 
DATA : PACKED RECORD 
NUMBER : §..255; 
CHARACTER : CHAR; 
INFO : PACKED ARRAY [1..8] OF 0..255; 
END; 


BEGIN 
WITH REQUESTCODE DO BEGIN 
CHANNEL: =9; 
STAT OR_CTRL:=1; 
RESERVED :=0; 
REQUEST NUM:=17; { this is the character replace code ; 
END; 


WITH DATA DO BEGIN 


NUMBER := 1; { How many characters to change \ 
CH :- ^ ^j ( which character to change j 
INFO [1] := 255; { character definition l 
INFO [2] := 255; { See page 166 of the 
INFO [3] := 255;  { STANDARD DEVICE DRIVER MANUAL 
INFO [4] := 255; 
INFO [5] := 255; 
INFO [6] := 255; 
INFO [7] := 255; 
INFO [8] := 255; 
END; 


UNITNUM:=1; 
UNITSTATUS (UNITNUM, DATA, REQUESTCODE) ; 


WRITELN (“ALL SPACES WILL NOW DISPLAY AS " "!7); 
END. 
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6522 VIA 


The 6522 Versatile Interface Adapter is a popular integrated circuit for use 
with microcomputers because of the many modes of operation availabie. The 
precursor to the 6522, the 6529, has been used in several interfaces with no 
difficultv. Unfortunately, although these two parts have identícal timing 
specifications, their operation is different. The 6528 is very tolerant of 
operation outside of the data sheet parameter limits while the 6522 must 
have it’s timing specifications exactly. 


The most critical timing parameter is the address set-up time which is the 
delay between the chip select and the rising edge of the LMHz clock. The 
Apple ///^s Device Select and 1 MHz clock are nearly identical, and the 6522 
will not operate under these conditions. The solution is to shorten the 
positive half-cycle of the 1 MHz waveform. This can be achieved by various 
methods, but, since the length of the positive half-cycle is critical, it is 
essential to have a well-controlled circuit to do this. 


The attached circuit is proposed for use with the Apple Hle Thë b322 CORK 
waveform is generated by using a 741574 circuit to delay the positive edge 
of the clock bv one cycle of the 7 MHz clock. The negative edge of the 
clock is set by the falling edge of the 1 MHz clock which also holds off the 
flip-flop until the next cycle. The result is a clock waveform which has a 
shortened positive half-cycle whose leading edge is delayed from the falling 
edge of Device Select by 149 nsec. 


The 55224 is required to meet the data sheet timing parameters. The 6522 
will usuallv work but it/s operation cannot be guaranteed. 


DEVSE! | | 
NEN | 
| | 
CEDCE | | 
| | 
(Continued) 
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SUGGESTED SCHEMATIC 





(25) +5 ----------------- R--------------------- —+----------- + 
| | 
| 4 | 74LS74 | 1d | | 
(40) Q0 — M y S ------------ 12 e | 
(30) M crees pe sg | +--|11 | | | 
|. d | | i | | | | 
LF d 2b. 7 | | 13 | | | 
| | | | | | | 
| SAR jugos EE | eese + | | 
dm +22 + | | 
| | 
| | 
(41) DEVSEL --------------- Peewee eaten [23 Fler. i] 
(18) BE $---- | ---------------- 122 | | 
| | | 24|-----+ 
EA E | 20 2 
(42) Di Ferse re |19 1l------------- 126 | 
(43) 06 er | 18 2 | ------------- | 27 | 
(#4) B Saas [17 8  3|------------- 128 | 
645) Dg Ser 116 3  4[------------- |29 | 
DE xD ME REDE |15 Y Ss) 38 6 | 
A ta |14 4  6|------------- 131 | 
EDI UA Smet es ae ER 7]------------- 132 5 | I/O Lines 
(49). D =>==== ==> |12 8|------------- | 32 ! | 
| | | 2 | Port A 
( 5) A3 ------------- =-------- ee 135 | 
E AA PA A 136 2 | and 
( 3) Al ------------------------------------ | 37 | 
EEE ar 138 A | Port B 
(31) RESET --------------------------------- | 34 | 
(30) TRO Mane AUAM dV SO |21 | 
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CONSOLE DRIVER.- SCREEN MODE 


The following program is a demostration of how to change the Apple /// 
screen mode. 


PROGRAM SCREENTEST; 


PROCEDURE SCREENMODE (NUMBER: INTEGER); 
VAR CH: CHAR; 


BEGIN 
IF NUMBER IN [@..2] THEN BEGIN ( If the given number is valid } 
WRITE (CHR (14)); { turn off the screen and } 
CH := CHR (16); 
UNITWRITE XL. CH, 15 12); ( send the prefix character } 


CH := CHR (NUMBER); 
ENITURLTE CL. OH, L4 512293 ( and the mode character. 
IF NUMBER = 2 THEN WRITE (CHR (1)); ( If 89 col, restore viewport. 
WRITE (CHR (28), CHR (15)); ( Clear screen and turn it on. 
END ELSE WRITELN (CHR (7), ^SCKEENMODE ERROR ^);  { else OOPS! 
END; 


A X nt egt 


PROCEDURE TESTERROR; 

BEGIN 
WRITE (CHR (28)); ( Clear the screen. } 
GOTOXY (90,11); 
WRITE (“This will generate an error. b ( Write some text. } 
SCREENMODE (5); [ Set an invalid mode. } 
WRITELN; 
WRITE (“Press RETURN to continue: Uer 

READLN; 


END; 


PROCEDURE TESTA; 
BEGIN 
SCREENMODE (Ø); i Set 49 column B/W mode. } 
GOTOXY (%,11); 
WRITELN (“This is 4f column text mode.^); 
WRITELN; 
WRITE (^Press RETURN to continue: E 
READLN; 
END; 


( Continued) 
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PROCEDURE TESTCOLOR; 

BEGIN 
SCREENMODE (1); { Set 49 column color mode. 
WRITE (CHR (20), CHR (4)); { Set background to Dark Green. 
WRITE (CHR (28)); í Clear the screen. 
WRITE (CER (19), CHR (13)); i Set forground to Yellow. 
GÜTOXY (PTL: 
WRITELN (“This is 40 column COLOR mode.^); 
WRITELN; 
WRITE (“Press RETURN to quit: ^); 
READLN; 

END; 


Ly A Z hep t+ 


BEGIN 

TESTERROR; 

TES 14: 
TESTCOLOR; 
SCREENMODE (2); 


n1 
E, 
C 
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CRRATA - STANDARD DEVICE DRIVERS MANUAL 
(030-9143B) 


Page 135 


All of the reference numbers on the keys need to have one added to them 
to match the table on page 136. 
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ERRATA - STANDARD DEVICE DRIVERS MANUAL 
(636-561435) 


Page 35 
There is an error in the listing at the top of the page. It reads: 
var: 
g array:array[6..26] of 9..255; 
begin 


g array[ß]:=19; g array[1]:=2; 
unitwrite(l,g array,2,,12); 
end; 2s 


It should read: 


var: 
g array: packed array[f..2ß] of 6..255; 

begin 
g array[£]:719; g arrayl[l]:=2; 
unitwrite(l,g array,2,,12); 

end; = 


Page 135 
All of the reference numbers on the keys need to have one added to them 
to match the table on page 136. 
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INDEX TO APPLE. ACCESS /// 


ALPHABETIC LISTING 
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999 Addendum - Apple Access /// 
DD i Business Basic Bootable Diskette 
2952 Dow Jones News and Quotes Access 
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Doc Issue Date Previous Date Pages 
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390 ALE 23851 = 16 
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BUSINESS BASIC-BOOTABLE DISKETTE. 


The instructions on page 36 for creating a Business Basic bootable diskette 
are misleading. Here is another way: 


1. Use System Utilities to format disk with name APPLCOM. 


2. Copy the following files from the Business Basic disk to 
APPLCOM. 


SOS.KERNAL 
SOS.INTERP 
S0S.DRIVER 


3. Copy the following files from the Apple Access /// disk to 
APPLCOM. 


ACCES) 

ACCESS3.LINV 

ACS SEONT 
“se the System Configuration Program to add RS232.DKIVEK to 
/ APPLCOM/SUS.DRIVEK. 


+- 
* 


1 
* 


RENAME ACCESS3, HELLO 


6. Type the following commands to restore the cursor wrap-around 
feature when you exit Access3: 


LOAD HELLO 
45 PRINT CHRS(4) 
SAVE HELLO 


7, Re-boot the system with /APPLCOM in the built-in drive. 


Please gefer to chapter 4 of the Apple /// Owner^s Guide for instructions 
QE . > * . * - U 4 

on formatting diskettes, copying files, and using the System Coufiguration 

Program. 
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DOW JONES NEWS AND QUOTES ACCESS 


The Dow Jones News and Quotes service, when accessed through Tymnet, will 
not respond to your password or proupt you further if Access /// has it’s 
X-ON handshaking protocol enabled. The X-ON protocol can be controlled in 
the open-apple-S menu. See page 28 of the Access /// manual for details. 
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ADDENDUM - APPLE ACCESS /// 


ACCESS /// Version l.l ADDENDUM 


TABLE OF CONTENTS PAGE 
Introdurtion. ............. a 22 a oel € 9» 94 9 9 9" $ P» A 4 R R 4 * ê 9 2 
New Features Summary. 5 9 & ê ê 5» R $9 ^ @ 9 83 8 # ».» 2» 9 9 9 ê » 9 ê 2 
Answerback 


Remote Control of the Recording File 
Queuing File Transmission 


Summary of Changes from Version 1.80......... 3 
What’s On the Master DiskettO...ooooooomom.o. 4 
Changes and New Features - sss ern nn UTE. 
Changes to the Main Menu...... V Rosa Va ON ACORN 6 


Additions to Set-Up Mode..... enn D 
Set the Answerback 
Change the Recording File Name 


Additions to the STATUS Screen....... eee 7 
New File Transmission Features......ooooooo.. / 
New Escape Sequences... < x e R e R K nn nnn 8 

Turn Recording Off 

Turn Recording On 

Turn the Filter Off 

Turn the Filter On 

Change the Recording File Name 

The Reply Sequence 
A New Command Key... ht mh mr ‚19 

Using ACCESS /// With a ProFile....... ell 

ProFile and O doe RE x ae ee Kao ek 


ProFile and Business BASIC........ O d sd 153 


Problems Reported and Resolutions..... eoe eS lo 
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INTRODUCTION 


ACCESS /// Version l.l includes numerous new features. This addendum 
describes these features. It also outlines differences between versions 
1.0 and 1.1 and lists problems with version 1.9 and how these problems have 
been resolved. 


This document will be part of the Access /// package. The Apple part 
number for the addendum will be 931-9243-B. 


NEW FEATURES SUMMARY 


Two new selections have been added to the Set-Up Menu, "Set the answerback" 
and "Change the recording file name." When you save the Set-Up settings, 
both the answerback text and the recording file name are saved and restored 
the next time you run ACCESS ///. 


You can now prepare a file for transmission and have transmission begin 
unattended after ACCESS /// receives a password that you specify. 


And, several new escape sequences have been added that permit a remote 
computer to completely control the recording capability. 


ANSWERBACK 


The answerback is a series of up to sixteen characters that is 
automatically transmitted when ACCESS /// receives a ctrl-E (ASCII 5). The 
answerback can be transmitted by operator command by holding down the 
open-apple key and pressing E. Selecting "Set the answerback" on the 
Set-Up menu lets you enter the text that will be transmitted. The 
answerback is saved along with the other Set-Up characteristics. 


REMOTE CONTROL OF THE RECORDING FILE 


Access /// Version l.l has a series of unique escape sequences that allow a 
remote computer to control the recording file. Sequences are provided to 
turn the filter on and off, turn recording on and off, and change the name 
of the recording file. These sequences are available ONLY when ACCESS /// 
is in ANSI mode. 
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QUEUING FILE TRANSMISSION 


You can now prepare a file for transmission and when ACCESS /// asks "Are 
you ready to start transmitting?" you can instruct ACCESS /// to queue the 
file. ACCESS /// then asks for a password of up to sixteen characters and 
displays a “waiting...” message. ACCESS /// waits for the password to be 
received over the RS232 line. When the complete password has been 
received, file transmission begins. 


ACCESS /// cannot be used while it is waiting for the password, but the 
wait can be aborted by pressing the ESCAPE key. Pressing ESCAPE also 
completely aborts file transmission. 


when ACCESS /// has finished transmitting the file, it automatically 
returns to terminal mode. 


SUMMARY OF CHANGES FROM VERSION 1.9 


Changing the name of the recording file is now done from the Set-Up menu 
rather than from che main menu. The name of the recording file is saved 
whenever Set-Up characteristics are saved. This makes it possible to name 
the default recording file anything you want. 


ihe recording filter now defaults to ON. Use the STATUS display to make 
sure that it is set the way you want. 


ACCESS /// version l.l lets you transmit Pascal text files. The header 
block is not transmitted, aud all DLE sequences are correctly expanded to 
the corresponding number of blanks. This means that a Pascal text file 
will appear to the receiving computer exactly the same as keys pressed on 
the keyboard. or, to put it another way, characters transmitted will be 
exactlv the same as if you had converted the Pascal text file to an ASCII 
tile using the Pascal zditor, and then transmitted the ASCII file. 
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WHAT’S ON THE MASTER DISKETTE 


If you catalog (or list the directory) of the ACCESS /// master diskette 
you will find the following files: 


/ APPLCOM Size File type 
*ACCESS3.CODE 61 Codefile 
*ACCESS3.INV 62 Codefile 
*RS232.DRIVER 7 Codefíle 
FACSIFONT 2 Datafile 
*ACCESS3 l Basicprog 
*SPSUB.CODE 3 Codefile 
*SOS.DRIVER 24 Sosfile 
*SEIPREFIX.IEXT 4 Textfile 
*SETPREFIX.CODE 2 Codefile 
*SACCESSJ.,PROFLLE 1 Basicprog 


This is a brief explanation of what each of those files is and why it is on 
the ACCESS /// master diskette. 


ACCESS3.CODE is the Pascal executable version of ACCESS ///. ACCESS /// is 
written entirely in assembly language. The assembly module is linked to a 
small Pascal host program to form this code file. 


ACCESS3.INV is a Business BASIC invokable module. This is the codefile 
that runs when you use Business BASIC. 


RS232.DRIVER is the device driver that manages the Apple /// built-in RS232 
interface. This driver must be part of the SOS.DRIVER file on your boot 
diskette in order for ACCESS /// to function correctly. This driver is 
exactly the same as the RS232 driver included on the Utilities Data 
diskette that accompanied your SOS system software. 


ACS3FONT is a character set font file in which line graphics characters 
replace the control character designations in the standard Apple HL 
character set. If your application requires the line graphic characters, 
then ACS3FONT must be configured into the SOS.DRIVER file on your boot 
diskette. If you do not use the graphics mode of ACCESS ///, then the 
standard Apple /// font may be used. 


ACCESS3 is a very short Business BASIC program that invokes the ACCESS /// 
invokable module. When you type "run access3” in Business BASIC, this is 

the program that is loaded and executed. It also temporarily sets a null 

prefix so that SOS will look for a diskette named /APPLCOM for ACCESS /// 

files like the recording file and the configuration file. If you want to 

run ACCESS /// from a ProFile, you should not use this program. Instead, 

see the section, "Using ACCESS /// With a ProFile.” 
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SPSUB.CODE is a short assembly language subroutine that sets the SOS prefix 
in the Pascal environment. It is supplied as a separate subroutine so that 
together with SETPREFIX.TEXT, you can customize your own prefix setting 
program if you have special requirements. Only users familiar with Pascal 
and linking assembly language modules should use this file. 


SOS.DRIVER is a device driver file that is already correctly configured for 
use with ACCESS ///. Although the individual components are also supplied 
on the System Utilities Data diskette, you can simply copy this file onto 
your boot diskette instead of creating a new system configuration. The 
following drivers are configured into this SOS.DRIVER file: 


‚CONSOLE 
SJILENIYPE 
RSL Ie 


The ACS3FONT is the system font, and four disk drives are configured. 


SETPREFIX.TEXT is the source listing of a Pascal program that permits you 
to change the SOS prefix. It is provided for users familiar with Pascal, 
and with linking to assembly language modules, so that prefix setting can 
be customized for unusual situations. 


SETPREFIX.CODE is a small Pascal program that is linked to an assembly 
language subroutine to allow you to set the 505 prefix. As explained later 
in "Using ACCESS /// with a ProFile", setting the prefix with the Pascal 
filer does not change the SOS prefix. This means that if you execute 
ACCESS /// from a ProFile without executing the SETPREFIX program, ACCESS 
/// will not be able to successfully save and load the Set-Up selections. 


To successfully execute ACCESS /// from a ProFile, in a Pascal environment, 
you must first execute SETPREFIX as described later in "Using ACCESS /// 
With a ProFile’. 


\CCESS3.PROFILE is a Business BASIC program that lets you run ACCESS /// 
from a ProFile in a Business BASIC environment. The only difference 
between this and the ACCESS3 Business BASIC program is the way in which the 
prefix is set. ACCESS3 sets a null prefix to force 505 to look for a 
diskette, while ACCESS3.PROFILE sets the prefix to /PROFILE which tells SOS 
to look for a subdirectory on the ProFile. For more information about this 


program, see “ProFile and Business BASIC," under "Using ACCESS /// with a 
ProFile’. 
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CHANGES AND NEW FEATURES 


CHANGES TO THE MAIN MENU 


Changing the name of the recording file is no longer done from the main 
menu. It is now an entry on the Set-Up menu, and is saved when the rest of 
the Set-Up settings are saved. 


ADDITIONS TO SET-UP MODE 


Two new selections have been added to the Set-Up menu, "Set the Answerback” 
and "Change the recording file name." 


When you save the Set-Up settings, both the answerback text and the 
recording file name are saved, and will be restored the next time you run 
ACCESS //7. 


SET THE ANSWERBACK 


Selecting this choice causes the screen to clear and the following message 
to be displayed: 


Answerback text? 


You can reply with up to sixteen characters followed by a RETURN. The 
RETURN is NOT stored as part of the answerback text. 


The characters that you enter will be transmitted by ACCESS /// whenever a 
CTRL-E (ASCII 5) is received. 

Control characters can be part of the answerback text. To enter them, hold 
down the open-apple key and the CONTROL key while pressíng the key you wish 
to enter. For example: to place a carriage return character in the middle 
of the answerback text you would hold down the open-apple and CONTROL keys 
and then press the M key. On the screen this will appear as one ot the 
line graphic characters, but it will be transmitted correctly, and can be 
saved correctly. 


See Appendix B of the Access /// manual for the ASCII codes associated with 
each key on the keyboard. 


You can also cause the answerback text to be transmitted without receiving 
the CTRL-E. Hold down the open-apple key and press the E key. 
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CHANGE THE RECORDING FILE NAME 


Selecting this option clears the screen and closes the old recording file. 
ACCESS /// prompts for entry of a new recording file name: 


"ew recordíng file name? 


It may be a block file pathname, or a character device name such as 
SWSOIBSENDIPES 


ADDITIONS TO THE SiAILS SCREEN 


The STATUS screen now displays the current answerback text in addition to 
all the previously dispiayed information. 


New FILE TRANSHISSIUN FEATURES 
Version l.l of ACCESS /// recognizes Pascal text files. It does not 
he header, and it correctly expands the DLE sequences to the 


transnit t 
eher or blanks. 


proper nu 


You can also queue any file for transmission at a later time. At the end 
of the transmit a file dialogue, you are asked to reply when ready to 
transmit. in answer of “Q" to this query will bring out the following 
request: 


¿ue password (ESC-RET to abort)? 


You can enter up to 16 characters for the password. After entry of the 
password AUCESS. /7/ displays: 

waitin. * 6 
ACCESS /// then compares every word it receives with the password you have 
entered. When ACCESS /// receives the exact password from the R5222 
interface, it will immediately start transmitting the file you have queued. 
While it is waiting, you cannot use ACCESS ///. 


If necessary, you can abort the wait by pressing the ESCAPE kev. 
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NEW ESCAPE SEQUENCES 


ACCESS /// has its own private escape sequences that are not part ot the 
VT19@ ANSI escape sequence set. These are active ONLY when ACCESS /// is 
in ANSI mode. 


All the ACCESS /// private escape sequences follow the ANSI format ot an 
escape character followed by a special character iead-in, and ending with a 
unique terminator. They follow the form: 


ESC * Pn Ps à 


Where ESC is the introductory escape character. The asterisk (*) is the 
special character lead-in that identifies the sequence as an ACCESS LE 
private escape sequence. Pn is a single digit parameter number that 
identifies the sequence. Ps is a parameter string that appears only in the 
sequence to change the recording file name. The unique terminator is the 
"at sign” 3 which is ASCII 64. 


In nost of the examples of escape sequences, the characters in the sequence 
are separated by spaces for easier reading. No real escape sequence should 
ever contain enbedded blanks. Doing so will have unpredictable 
consequences. 


The valid values for Pn are: 


Pn Meaning 

D Turn recording off 
i Turn recording on 

2 Turn the filter off 
3 Turn the filter on 


Change the recording file name 


E 


TURN RECORDING OFF 
It is possible to have a remote computer turn recording on and off. This 
is done by sending ACCESS /// a special escape sequence. To turn recording 


off, simply have the remote computer send ACCESS /// the following 
characters, in the order shown: 


ESC * ø a 


ESC is the escape character (ASCII 27). 
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TERN. RECORDING QN 


iT 


to turn recordiag on, send ACCESS /// the following characters, in tr 
order shown: 


ne x9 
xls 1 L - IM Do H at L 
¿pon receipt of the foilowing characters, ACCESS 777 turns the recording 
tilter off: 
lic * 2 8 


wie EC CD rs euius AA 99 
xin. bo. AE ru character AOL L IE Yu 


~ 
4 


The following characters will cause ACCESS /// to turn the recording filter 


e fy 


r 


on: 

Lax Wu 
= " T -— a T» , dE vd oe de nir. 
SE, Ope tae scams character (ani eds 
moe KN x ` - sae 7.7... gat TUM ST. Ta. m rn = 
O, ccu cua. ELLE Sale 


This seruence causes ACCESS /// to close the old recording iile and open a 
new one The name of the new file is included in the sequence. it can be 


2 ^ a 
ı blank Cile pathname or a character device aane. 
when ACCESS /// is done processing the sequence, it transaits a reply that 
indicates the success of the operation, or gives an error code that 


describes the difficulty. 

The sequence to change the recording file name is: 
z3C * 4 filename Y 

where :32 is the escape character (ASCII 27), and "filename" is a valid 505 


pathname 30 characters in length or less. The sequence must contains NO 
embedded spaces and it must end with the "at sign’. 
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Some sample sequences: 


ESC*A.SILENTYPEG 
ESC*4/APPLCOM/TERMRECQ 
ESC*4/PROFILE/MYFILE.DATA@ 


The Reply Sequence 


ACCESS /// returns an escape sequence in acknowledgment ONLY to a request 
to change the recording file name. This escape sequence is: 


ESC * Pe 


where ESC is the escape character (ASCII 27) and Pe is the SOS error code 
plus 32(decimal). The offset of 32 is added to the error code so that the 
reply sequence will not include any control characters which might 
adversely affect some remote computers. 


If the recording file name change is successful, then Pe is the blank 
character (ASCII 32 plus the SOS OK code of zero). If the new recording 
tile already exists Pe is 32 (decimal) plus the SOS error code 47 (hex), 
for a total of 103 (decimal) which is a lower case "g^ 


When ACCESS /// receives the escape sequence commanding the name change, it 
first checks the new recording file name for validity. If any problems are 
found, the SOS error code (+32) is returned in the reply sequence. If no 
probleus are found, the old recording file is closed, the new oue is 
opened, and the operation successful reply sequence is sent. 


The reply sequence is NOT followed by a carriage return. 


If the new recording file cannot be successfully opened, the previous 
recording file is reinstated. If the previous recording file was a disk 
file, the file pointer is moved to the end of the file so that any 
additional recorded information will be added to the end. 


A NEW COMMAND KEY 
It is possible to force transmission of the answerback text by holding down 
the open-apple key and pressing the "E" key. The complete answerback text 


is transmitted every time the "E" key is pressed with the open-apple key 
held down. 


(Continued) 


APPLE TECH NOTES Copyright (C) 1982 by Apple Computer, Inc. 


— wwe — — ~ s — 0 — u — ee — ee ca xx —— A MP A VE m, c - A ee UA UAM es Gu A ARR uA - ee UAM M GAAP ee ee Cu A CUP Cams umm c c GA Gm um Gu c cp occ o eae eS ee ee c — ue 


— — a ee uA ee — A— MÀ oA ee A— ee ee —À — — — he A wA —— a —  — a ee - k — — E eee eee — — — — X — << e i— o —Á cv —ÁÀ —À c -—— —— c K — c^ oue oum — — — 


USING ACCESS /// WITH A PROFILE 


ACCESS /// can be used from a ProFile. The procedure differs slightly 
depending on whether you usually use Pascal or Business BASIC. 


No matter what language you are using, you must have a correctly configured 
OR RIVER File to use the Profile. The SOS.DRIVER file included on the 
guss / master diskette does not have a ProFile driver in it. You can 
use the system configuration feature of the Utility program to add the 
>rıseile driver to the SOS.DRIVER file from the ACCESS /// master diskette, 
or veu can construct a new SOS.DRIVER file. Just be sure that your new 
iriyer Stile contains both the RS232 driver and the ACS3FONT character font 


“ron the ACCZSS /// master diskette. 


^nsult tne Standard Device Drivers Manual for instructions on how to 
SJS.DRIVER file. 

ing discussions it is assuned that the root volume name of 
cuv Braille is PROFILE. The root volume name is the one that is 
¡isplavel if the top of any directory listing of the device. If your 


par 


>rarile has 1 different volume name, substitute it for /PROFILE in all 
Erde SA ol aE a Sr 
ete SO LOS 


Ii also assumed that vou have already configured your system diskette to 
taciude the Profile driver, and vou have read and followed the instructions 
“sr settins un and using your Profile. 


WE ea, hae a E 
‚2. "ıscal, use the Pascal Filer to create a subdirectory on the 
Pear Ph Sa Sea APPLCOM. This is done with. the. Make «command as Follows: 


3 what file? appleom! [4] 


The exociliízation point after the subdirectory name telis the riler that 
a creating a subdirectory. The four in square brackets is the amount 
‚2 pace vou re allocating tor the subdirectory. 


a 
— 
'1 
il 

4 
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After the subdirectory has been created, transfer ACCESS3.CODE to that 
subdirectory. 


T 
Transfer what file? /APPLCOM/ACCESS3.CODE 
To where? /PROFILE/APPLCOM/ACCESS3.CODE 


Then transfer SETPREFIX.CODE to the root volume of your ProFile. 


T 
Transfer what file? /APPLCOM/SETPREFIX.CODE 
To where? /PROFILE/SETPREFIX.CODE 


BEFORE YOU EXECUTE ACCESS /// you must execute SETPREFIX and 
set the prefix. If the volume name of your ProFile is /PROFILE, then you 
must set the prefix to: 


/PROFILE 


This has to be done with the SETPREFIX program. If you set the prefix with 
the Filer, Pascal keeps its own prefix and does not set the SOS prefix, and 
ACCESS /// will not find the files it needs. 


You will find that the prefix set with the SETPREFIX program does not 
interfere with the Pascal prefix, and, in fact, a different prefix may be 
set by each. But for the sake of consistency, you should always have the 
Pascal prefix set identically with the 505 prefix. To do this, set the 
prefix with the Filer and then set the same prefix with the SETPREFIX 
program. 


When vou get all done you should be able to type: 


X 
Txecute what file? APPLCOM/ACCESS3 


and ACCESS /// will be run from the subdirectory. If you get an error 
message then you probably don’t have your prefixes set properly. 


If the prefixes are correctly set, you can save the Set-Up settings and 
they will be loaded automatically the next time you execute ACCESS ///. 


(Continued) 


APPLE. TECH NOTES Copyright (C) 1982 by Apple Computer, Inc. 


A — — c c3 u k A ooo A mom cmo oM coo o o ee O A c OM Me a R he A os code bd HA POEM cM cuoc g RÀ c c m —— - m —— ee ei 


— — =r — — ee — A c r er A Am cu a cm c» cm c o o mim dm m im Sm. eee 0 au 


PROFILE AND BUSINESS BASIC 

Use the Utility program to make a subdirectory on the Prorile callec 
APPLCOM. To do that, select the file handling commands and "Make a new 
sabda irector + 


The new subdirectory name shouid be: 


IL 


T] 
(71 


ld 


EP: FAPPLCOM 


G 
"ith room for 5 files. 


Press ESCAPE to return to tne file handling commands menu and select "Copy 
files”. Copy the following files from the master disk to the ProFile. Put 
the ACCESS /// master diskette into one of the Apple /// disk drives, then 


cvpe: 


id stress the up arrow kev. Utility will display a list of the files on 
che ACCESS 577 diskette on the right hand side of your screen. Press the 

|; and down arrow xevs to liae up the selection arrow with the name of the 
File to be selected, and select it by pressing the right arrow. 


"siag this method, select the following files from the diskette: 


AG d DER E E 

RULES an S 
After vou Have selected both files, press RETURN to accept the selection. 
"or the destination ("To the files:") type: 


J PRUFILE/APPLCOM/= 


and press RETURN. Utility will transfer the files you have selected to the 
subdirectory on the Prorile. 


Tne file ACCESS3.PROFILE is a small Business BASIC program that sets the 


srefix and invokes ACCESS ///. 


You may need to change it if, for any reason, your subdirectory is named 
differently than given above. To do this, type the following: 


)load /profile/applcom/access3.profile 
list 


And you will see the following listing: 
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19 aS=PREFLXS 

20 PREFIXS="/PROFILE" 

30 INVOKE "APPLCOM/ACCESS3.INV" 
40 PERFORM ACCESS3 

50 PREFIX$=a$ 

60 END 


If vou want to shorten the typing required to run ACCESS ///, type: 
)save /profile/applcom/access3 


This will save a new Business BASIC program called ACCESS in the 
subdirectory on your ProFile. It changes the name fron ACCESSJ.PROFILE to 
just ACCESS3. 


The program works as follows: 


Line 1Y saves the old prefix. 

Line 28 sets the prefix to the volume that 
contains the ACCESS /// subdirectory. 

Line 30 brings ACCESS /// into memory, and 

Line 40 starts it up. When you exit ACCESS If 

Line 59 restores the prefix to its original value. 


1 this program vou don’t have to worry about setting the prefix with the 
IPRErix program, just type: 


Pp 
4 T 
c 


‘run /profile/applcom/access3 
and everything will work correctly. 
NOTE: If the volume name of your ProFile is different from "/PROFILE”, you 
will have to change this Business BASIC program so that is sets the correct 


prefix. Just substitute the volume name of your ProFile in line 29 before 
saving the program with the new name. 
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PROBLEMS REPORTED AND RESOLUTIONS 


The following problems reported for ACCESS /// Version 1.9 have been 
addressed as noted for version l.l. 


2) when used from Business BASIL, ACCESS /// V1.0 did not recognize the 


7 


escape key to abort the entry of the name of a file to transmit. 
Resolutrton. f$ Version isle Fixed, 
ed ¿ron Business D2ASiU, ACCESS /// leaves the Apple /// in a 


us 
state that prevents many programs, including the VOLUMES program, fron 


PENIS 


a X *o918 pa 
ng: AIL 


vesnlution ry Version 73: Fixed; 


3) Patznames for non-block files or devices were accepted as valid files to 


. 
=a - 


PR. gi Gere ea d 
Pere Ga ds 


= st, bye N UL A di PT win? > R Ñ . M Ta 1 a 2?) C c r: ) [A = E , 
BLEU eek. GI eee dg A bk. een HIE b LOG LI le patnnanes are now 
accented, The criteria usad is: if there is a leading period, 

estu, A e el: PIGH. 


Woo geo Ses dispiavs Che opeü-appie character on receiving the character 


` 


ro Ds de oe > MERCEDES: e E a S a E - k 4] a 
Ute sarg vulch is used DY many systems as a pad character, 
: E "s Ex DES L he "uo qe r - ` é . LEE = a1 n ina * Ñ * , > . Br 
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Oa eet: qe version cals The Sroonc now dladicares Fiat LSCAPZ 
s.d pss required. 
OC QE DS GS es Torget CO turit on the Senor dia lec, wheter 25 usdalls 
ERE 


"ue wal tides 3usuld be recorded. 


4 ra 


lon in Version iL! "oe recording filter is now X 


; it isn't possible to save the name of the recordias fiie, so that the 
idlqult aan be set by the us 


set. 


Sesoliution in Version i..: Changing the name of the recording file 
nas been moved to the Set-Up menu where it can be saved along with 
tie cher 3et-Up parameters. 
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8) ACCESS /// will not decipher Pascal text files. 


Resolution in Version l.l: Pascal text files are now recognized by 
their SOS file type code. The header is NOT transmitted, and all 
DLE sequences are correctly expanded. 


9) The Version 1.9 manual mentions that a backup disk is included in the 
ACCESS /// package. There is only one diskette in the package. 


Resolution in Version l.l: Inclusion of a backup diskette is 
unnecessary as users are able to make their own backups. 
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BOOTING WITH DOS 3.3 


Apple Adventure is shipped in a protected DOS 3.2 format. If you want to 
save a game to continue play later, you will need a DOS 3.2 formatted 
diskette. Please ask your dealer to INITialize a diskette with DOS 3.2. 


You can initialize more 3.2 diskettes by booting with BASICS and the DOS 
3.2 diskette that the dealer initialized for you, inserting a blank 
diskette in the drive, and typing INIT HELLO. 


The MUFFIN program won't work on Adventure because of its software 
protection scheme. 
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>32768 ERROR 


If the Apple^s memory initializes to $89 in the variable storage area then 
the program will stop at line 1620 with a “>32768 ERROR”. Attempting to 
PRINT K(19) will give the same error. 


Try running another program first to initialize that area of memory. 
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SUPER SERIAL CARD AND APPLE PLOT 


Apple Plot won^t work with the Super Serial Card. The Qume plotting 
routines in Apple Plot were written explicitly for the High Speed Serial 
Interface. The Qume plotting routines would have to be rewritten because 
the hardware to transmit characters is different on the two cards. 
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GRAPHICS PRINTERS 


Using printers other than the Silentype or Qume with the Apple Plot progran 
is accomplished by saving the graphs generated by the user in Apple Plot ín 
picture files (page 18-29 of the Apple Plot manual), exiting Apple Plot by 
pressing Q, and then BLOADing the picture files into memory and dumping the 
high resolution graphics page to your printer. A graphics driver must exist 
for the printer you are using. See you dealer for more information on 
obtaining a graphics driver. 
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“ERRORS 


An ERROR #53 (ILLEGAL GUANTITY ZXROR:  Appleso*t 11 Xeference “atuil, page 
81) can occur in Apple Fist ior two known reasons.  .he :irst Teuson for the 
occurrence of the ILLEGAL ¿LANTITY ERROR is tne t.cating labels setable dy 
the user in tne X-axis paraceters menu. Page 23 turcugh 15 of the Appie 
Plot manual describes the s-axis parameters menu tornat. if the user 
responds: to tog Ingulo “LS. LABEL L $2" E "ESE tases, 02 1^ witira “Les. 
response and then responds “Yo” to the “CHANGE LABEL. *i 27 or “CHANGE LABEL 
7 A 


ws, the result will b 


D 


"JI T Anauıre Wicca Class in ZXROR #53 during the 


graph displa;. 


The second reason is connected with the bar chart graph format. There is a 
bug ia tne bar chart format chat makes the ending plot point of the plot 
t in t.e 
‘see page .3 of the Apple Plot manual). The 
change in the clot range will occur during the display of the graph and if 
the ending plot point becomes less than the beginning plot point an ERROR 
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CONVERTING TO DOS 3.3 


The MUFFIN program can be successfully run on the Apple Plot diskette to 
convert the 13 sector program to a 16 sector formar with no side eitecis 
whatsoever. See Appendix K of the DOS 3.3 manual for instructions on the 
use of the MUFFIN program . 
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ERRATA - APPLE PLOT MANUAL 
A2L0937 
030-9116-09 


Page 9 
The data for day 17 should be "63 1/2" instead of "63 11/2". 


Page 22 
Paragraph 5, line 1, "Apple Plot will plot one bat" should be "one bar". 


Page 26 

To overlay graphs the user must toggle the overlay graph format, recall 
data from the diskette, and DISPLAY the graph to get the third, fourth, 
etc. plots to overlay the first and second plots. 


Page 36 and 38 

Using either the DX or DY commands from the edit/entry section of 
Apple Piot will result in deletion of both the X and Y coordinates, as 
opposed to just the X coordinate or the Y coordinate depending on the 
command used. 


Page 43 
Paragraph 3 line 9 reads "...be, aand..." and should read "...be, and... 


Page 46 

Silentype paragraph. The word backplane is nebulous and inaccurate if 
certain assumptions are made. Slot 1 is on the motherboard. Use the term 
"motherboard" instead of backplane. 


Page 47 
Paragraph 3 line 1 reads "...type l to select the Qume..." and should read 
"..type 2 to select the Qume..." 


LE] 


Page 53 

The Visicalc instructions should contain a warning that columns containing 
labels (or non numeric information) will become points of zero value in the 
data of the Apple Plot file. 


Page 53 and 54 

The description for doing a Visicalc file conversion is unclear. Even when 
a user creates a file using /PD as described, he cannot have a full 199 
data points. The reason for this is that Apple Plots Visicalc file 
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converter is reading in strings, these may be less than 255 characters long 
and will be truncated after 239 characters have been read. The result is 
that if a default column width of 9 is used then the maximum number of 
soints that can be converted is about 26. 


Ln general che Apple Plot manual should have stated that error messages in 
the program are Applesoft error codes so that users can reference the 
proper manual to find out what went wrong. 
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ERRATA - APPLE PLOT MANUAL 
A2L9937 
030-0116-909 


Page 9 
The data for day 17 should be "63 1/2" instead of "63 11/2". 


Page 23 
Paragraph 5, line 1, "Apple Plot will plot one bat" should be "one bar". 


Page 26 

To overlay graphs the user must toggle the overlay graph format, recall 
data from the diskette, and DISPLAY the graph to get the third, fourth, 
etc. plots to overlay the first and second plots. 


Page 36 and 38 

Using either the DX or DY commands from the edit/entry section of 
Apple Plot will result in deletion of both the X and Y coordinates, as 
opposed to just the X coordinate or the Y coordinate depending on the 
command used. 


Page 43 
Paragraph 3 line 9 reads "...be, aand..." and should read "...be, and..." 


Page 46 

Silentype paragraph. The word backplane is nebulous and inaccurate if 
certain assumptions are made. Slot 1 is on the motherboard. Use the term 
"motherboard" instead of backplane. 


Page 47 
Paragraph 3 line 1 reads "...type 1 to select the Qume..." and should read 
"type 2 to select the Qume..." 


Page 53 

The Visicalc instructions should contain a warning that columns containing 
labels (or non numeric information) will become points of zero value in the 
data of the Apple Plot file. 


Page 53 and 54 

The description for doing a Visicalc file conversion is unclear. Even when 
a user creates a file using /PD as described, he cannot have a full 10$ 
data points. The reason for this is that Apple Plots Visicalc file 
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converter is reading in strings, these may be less than 255 characters long 
and will be truncated after 239 characters have been read. The result ís 
that if a default column width of 9 is used then the maximum number of 
points that can be converted is about 26. 


In general the Apple Plot manual should have stated that error messages in 
the program are Applesoft error codes so that users can reference the 
proper manual to find out what went wrong. 
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PAGE LENGTH ON PRINTOUT 


The page length parameter in the configuration menu is never used by Apple 
Post. It will always assume 6 lines per page. However, it is possible to 
modifv the program to recognize the page length parameter: 


LOAD OUTPUT MODULE 
UNLOCK OUTPUT MODULE 
35300 IF LK => NL THEN PRINT CHR$(12):COSUB 39999 


35270 REM 
35350 GOSUB 9$ 


Sr. LP Ld. MODbLE 
LYCR- ULTPLT MODULE 


This modification assumes that priutiag an ASCII form-feed character will 
cause the orinter to advance to the top of the next page. Printers that 
don’t support this feature will need to substitute several PRINT statements 
in the place of PRINT CHRS(12) in line 35399. 
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PRINTERS BEING IGNORED 


Apple Post doesn't work with some printers because Apple Post looks at the 
PROMs on the interface card too see which kind it is, and ignores aon-Apple 
cards. You can force the decision by adding the following modifications to 
two of the modules: 


UTILITY MODULE and OUTPUT MODULE 
13135 V= <code> 1125 X2= <code> 
where <code> = 1 for an Apple Parallel Printer Interface 


2 for an Apple High Speed Serial Interface 
3 for an Apple Communications Interface 


Suggestion: Use the code for the serial card (2) when interfacing a 
non-Apple card so that Apple Post will use the firmware on the interface 
card. Be sure to make backup copies of your diskettes before making ANY 
changes! 
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LABELS AND THE LEFT MARGIN 
To move the printing on the LABELS away from the left margin, change one 
line in the OUTPUT MODULE: 
37439 PRINT BFS(W) 
to 
37439 PRINT TAB (19);BFS(W) 


The number in the TAB statement determines how wide the left margin will be. 


APPLE TECH NOTES Copyright (C) 1983 by Apple Computer, Inc. 


mm emma am t 


— e er —À MÀ — A — r vn —— m "DO k -m CA c — o m —— X - MÀ hei i - om Mi md b g k m m. um AH Be AGRO A CUm umo r k m o mom moo mo m Cm ARR ARR ui w ten mmo HE mr he 


ZIP CODES 


In LIST or PHONELIST, an error will occur if CITYSTATE-20 and SORTKEY-19 and 
ZiP>=6 digits (sum > 36). The status module will come on line with an 


error. To avoid this problem add the following liae to the OUTPUT MODULE: 


35123 IF LEN (R39(3))+ LEN (RS(4)) + LEN (R$(7)) > 36 THEN G3$="": 
GOTO 35139 


The above fix will become increasing important when zip codes become 9 
digits long. 
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FILE SIZE 


Apple Post is limited to 500 names per diskette in a 2 disk system because 


the boot drive must hold the Apple Post program. If the file has more than 
589 names, you have two options: 


* get another drive for each additional 59$ names 


* break the file into logical parts, each with a unique name, using 
separate diskettes 
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SAMPLE LIST 


The Sample data file in Apple Post is for example purposes ONLY! It nas 
room for only a few names - If you used this file as a mailing list file vou 
must re-enter the data into a new file. See NEWLIST on page 9 of the Appie 


Post manual. The warning against using the SAMPLE file as a mailing list 
file is located on page 5 of the Apple Post manual. 
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FORMAT COMMAND 


The FORMAT command allows an Apple Post user to set the label height for 
printing labels. Setting the label height to 5 lines will print 6 lines per 
label nevertheless. To correct this problem add the following line to the 
OUIPUI- MODULE: 


37448 IF LH = 5 THEN 37465 
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Apple Post can be MUFFINed successfully to the l6-sector format. However, 
Apple Post does not take advantage of the extra disk space and the number of 
entries per list remains the same as for l3-sector diskettes. The advantage 
of using l6-sector format is convenience in booting up the Apple Post 
program. 
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BOOTING STELLAR INVADERS UNDER DOS 3.3 


Apple Stellar Invaders is a Pascal diskette set up to boot on a 13 sector, 
DOS 3.2, Apple II. You must use the BASICS: diskette to get it to boot on 
a 16 sector, DOS 3.3, system. The BOOT13 program on the DOS 3.3 diskette 
won t work. 


APPLE TECH NOTES Copyright (C) 1981 by Apple Computer, Inc. 


—— Pn nere nn | 


— | 1. 
HA am aum p mp A — He es — O P ANA VENE SEHE: came A CR m m ca) e ee ee m amd A UP m m m cc m -a — a— a— m A A —— a c m GE ac (EEE par hi GE - mp m m a ua a h GENES cA ct ee eke 


STELLAR INVADERS AND 89 COLUMN VIDEO CARDS 


Apple Stellar Invaders will not work properly if you have a 89 column card 
like the Smarterm or a communication card in slot 3. It is a Pascal format 
diskette. It will turn on the Smarterm card and direct the text output to 
the normal Appie screen. 
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DATA FORMAT 


The characters in Apple Writer are not stored in either true ASCII or the 
Apples version of ASCII. 


Most significant 4 bits 


ø 2 4 6 8 À C E 
ASCII cc n UC Le 
APPLE ce n Uc lc 
APPLE WRITER UC n cc lc n 


cc control character 
n numbers 

UC Upper case 

lc lower case 


Apple Writer stores its information in memory starting at locatiom $1991. 
LOMEM ($1900) and HIMEM (S95FF) must contain $83 which marks the limits of 
memory. While editing, everything above the cursor on the screen starts at 
LOMEM and is toppped off by a $69 and everything below the cursor on the 
screen is pushed up against HIMEM with another $69 below it. So the file 
is defined by the two end of file markers ($83) with a hole in the middle 
defined by the two cursors (S69). 


As the cursor on the screen is moved through a file, one character at a 


time is being moved from one $60 marker in memory to the other. The 
distance between the two markers is the remaining free memory. 
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COM CARD PRINT ROUTINE 


The COM CARD PRINTER DRIVER needs to be loaded and ínitialized each time 
you enter the PRINT module. Here is a short program that will load the 
printer driver, initialize it, and enter the print routine. 


FP 

19 PRINT CHRS$(4);"BLOAD PRINT ROUTINE" 
20 CALL 775 

3$ PRINT CHRS(4);" PR" 

46 PRINT CHRS(4);"BRUN PRINTER" 

SAVE PRINTER SETUP 


And heres how to use it 


Q Exit Apple Writer 

RUN PRINTER SETUP Run the set-up program 

L Load the file (if necessary) 
P Print new document 

J Change the printer address 
304 To the print routine 
<RETURN> Print the file 
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SERIAL CARD HANDSHAKE ROUTINE 


The SERIAL CARD HANDSHAKE ROUTINE needs to be loaded and initialized each 
time you enter the PRINT module. Here is a short program that will load 
the print routine, initialize it, and enter the print mode. 


FP 

19 PRINT CHR$(4);"BLOAD PRINT ROUTINE" 
20 CALL 944 

30 PRINT CHR$(4);"PR#B" 

40 PRINT CHRS(4);" BRUN PRINTER" 

SAVE PRINTER SETUP 


And here’s how to use it 


Q Exit Apple Writer 

RUN PRINTER SETUP Run the set-up program 

L Load the file (if necessary) 
P Print new document 

J Change the printer address 
3C5 To the print routine 
<RETURN> Print it 
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PARALLEL PRINTER INTERFACE 


There are instructions starting on page 62 of the Apple Writer manual on 
how to use Apple Writer with an Apple Parallel Printer Interface. However, 
they are a bit clumsy. Here is how to modify the HELLO program on your 
Apple Writer diskette so that it will initialize the printer automatically. 


LOAD HELLO 

L PRINT CHRS (4);"PR£l" 
2 PRINT CHRS (9);"132N" 
3 PRINT CHRS (4); "PRHO" 
UNLOCK HELLO 

SAVE HELLO 

LOCK HELLO 


When you print a file be sure that option J, PRINTER ADDRESS, contains 
$C192. 
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TRANSMITTING FILES THROUGH THE COMMUNICATIONS CARD 


It’s easy to send your Apple Writer files out to another computer with the 
Communications card. First, boot Apple Writer and load the file that you 
want to send. Select the "P" for print option. When you get to the PRINT 
menu, select "Q" for quit. Now get into terminal mode by typing: 


IN#2 <RETURN> assuming that you're in slot 2 
control-A control-F set up terminal mode 


OK, now you're ready to sign on and get the other computer ready to accept 
the information. When the other computer is ready to go, type: 


control-A control-X To exit terminal mode 
CALL 2951 To re-enter Apple Writer 
P To print a new document 

d Change printer address to 
C295 Aim it at the Com Card 


Then proceed to print as usual and the information will get to the other 
computer. Quit Apple Writer and do the IN#2 sequence again to do your 
sign-off. 


The Communications card doesn”t send out linefeeds with its carriage 
returns, so this probably won't work with serial printers. 
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RE-STARTING APPLE WRITER 


You can re-start the Apple Writer Editor or Printer at any time without 
destroying the file in memory with CALL 2051 from either Basic or 803G from 
the monitor. 


An Apple Writer slave diskette can be booted without affecting the current 
file in memory. See the DOS Manual, pages 13 and 141, for more information 
about slave diskettes. 
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CONVERT APPLE WRITER FILES TO DOS TEXT FILES 


The following program will convert an Apple Writer file into a DOS text 
file. It doesn't do any formatting or insert any carriage returns into the 
text file. This means that long paragraphs won't load with INPUT 
Statements in Basic. 


19 D$ = CHRS (4) 
20 HOME 
39 ONERR GOTO 499 
40 PRINT DS"MON 0" 
10Ó INPUT "APPLE WRITER FILE NAME? TEXT.";AS$ 
110 PRINT DS"BLOAD TEXT."AS 
120 PRINT : PRINT A$" LOADED" 
138 PRINT : INPUT "DESTINATION? “¿TS 
149 AD = 6481 
150 PRINT DS"OPEN "T$ 
160 PRINT DS"WRITE "T$ 
170 A = PEEK (AD) 
A + 1 


189 AD = AD 
19 IF A> = 224 THEN A =A - 64 
200 IF A> = 192 THEN A = A + 32 
210 IF A < 32 THEN A= A+ 192 
220 IF A < 64 THEN A= A+ 128 
239 IF A= 96 THEN 400 
240 PRINT CHRS (A); 
250 GOTO 176 
40 PRINT : PRINT DS"CLOSE" 
416 PRINT "DONE" 

(Continued) 
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The resultant text file needs to be broken up to work on it from Basic. 
The following program will read a DOS sequential text file and send its 
contents to the interface in slot l. It is careful not to strip off any 
leading spaces. 


LODO  ONERR GOTO 2999 

191g LET DS = CHRS (4) 

1020 INPUT "FILE NAME? ";FS$ 

1030 PRINT D$;"OPEN ";F$ 

1848 PRINT DS;" READ ";FS 

1959 REM MAIN READ-PRINT LOOP 
1969 GET AS 

1970 PR 1 

1089 PRINT AS; 

1990 GOTO 196% 

20900 REM FILE DONE, FINISH UP 
2010 CALL 1092 

2020 PRINT 

2030 PRINT DS;" CLOSE" 

2048 END 
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CONVERT DOS TEXT FILES TO APPLE WRITEK FILES 


The following program will convert a DOS text file to Apple Writer format 
and saves it to the disk. The destination file name will be the name you 
gave to the first question with "TEXT." added to the front. 


199 
119 
129 
139 
149 
158 
164 
179 
189 
199 
209 
219 
39D 
314 
320 
339 
349 
359 
360 
374 
389 
399 
499 
419 
429 
439 
449 
459 


LET DS = CHRS (4) 

ONERR GOTO 386 

HOME 

FOR I = 768 TO 808 

READ J: POKE I,J: NEXT : RETURN 

DATA 169,1,133,38,169,25 

DATA 133,31,32,12,253,169 

DATA 0,9,128,201,141,2498,12 

DATA 281,160,144,241,291 

DATA 224,144,2,233,97,105 

DATA 64,145,30,230, 30,208 

DATA 227 ,230,31,298,223 

VTAB 19: INPUT "TEXT FILE TO TRANSFER: ";N$ 
PRINT : INPUT "FROM WHICH DRIVE: ";INS$ 

IN = VAL (INS) 

IF IN > 2 THEN 199 

IF IN > Ø THEN PRINT D$;"OPEN ";NS;",D";IN 
IF IN = f THEN PRINT DS;"OPEN "¿NS 

PRINT D$;" READ ";NS 

CALL 768 

PRINT DS; "CLOSE ";N$ 

POKE 216,8 

POKE 6400,131 

LET E = PEEK (30) + PEEK (31) * 256 

POKE E,96 

PRINT 

PRINT DS;"BSAVE TEXT." ;NS; ,AS1990,L';E - 6409 + 1 
PRINT : PRINT "DONE" 
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APPLE WRITER AND CARRIAGE RETURNS 


Apple Writer^s printer output module always prints at least one character 
on each line. It sends out a space character before the carríage return on 
a "blank" line. This can interfere with some printers. Here is how to 
modify the PRINTER module to stop sending the extra spaces. 


UNLOCK PRINTER 
BLOAD PRINTER 

CALL -155 

1000:EA EA EA EA EA 

ÖDEB:EA EA EA EA EA 

QFCD:EA EA EA EA EA 

ÜFEB:EA EA EA EA EA 

1243:EA EA EA EA EA 

15B9:EA EA EA EA EA 

3D6G 

BSAVE PRINTER, AS803, LS1@1C 
LOCK PRINTER 
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APPLE WRITER AND CARRIAGE RETURNS 


Apple Writer^s printer output module always prints at least one character 


on each line. 


a "blank" line. 


UNLOCK PRINTER 


It sends out a space character before the carriage return on 


This can interfere with some printers. Here is how to 
modify the PRINTER module to stop sending the extra spaces. 


BLOAD PRINTER 
CALL -155 


1609: 
ÖDEB: 
ÖFCD: 
ÖFEB: 
:EA 
EA 


1243 
15B9 


3DØG 


EA 
EA 
EA 
EA 


EA 
EA 
EA 
EA 
EA 
EA 


EA 
EÀ 
EA 
EA 
EA 
EA 


EA 
EA 
EA 
EA 
EA 
EA 


EA 
EA 
EA 
EA 
EA 
EA 


BSAVE PRINTER, AS8ß3, LS1@1C 
LOCK PRINTER 
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CASSETTE FILE STORAGE 


The following program was written for those people who want to send Apple 
Writer files through the mail on cassette instead of diskette. It requires 
that both parties have Apple Writer 1.0 or l.i. The original file must be 
on diskette. The received file will automatically be saved to diskette. 


199 REM 
CASSETTE APPLE-WRITER 
BY GROVER F. NUNNERY 
APPLE COMPUTER, INC 
CHARLOTTE, NC 


192 TEXT : NORMAL : SPEED- 255 


104 AS = “"kkkkkkkkkkkěkkkkkkkkkkkkk 
kkkkkkkkkkkkkkkk" 
1ø6 BS 2 tkk" 


108 BELS = CHRS (7): REM CTRL-G 
119 DS = CHRS (13) + CHRS (4): REM 
<CR> + CTRL-D 
112 PRINT D$;"NOMON C,I,0" 
200 REM 
TITLE 


202 HOME : PRINT AS: PRINT B$;: HTAB 
9: PRINT "APPLE WRITER 1.8 / 
1.1";: HTAB 38: PRINT B$ 

204 PRINT BS;: HTAB 38: PRINT BS 

206 PRINT BS;: HTAB 13: PRINT ^C 
ASSETTE FILER";: HTAB 38: PRINT 
BS 

208 PRINT BS;: HTAB 38: PRINT B$ 

210 PRINT BS;“ BY GROVER NUNNERY 
, APPLE COMPUTER ";B$ 

212 PRINT AS: POKE 34,8: PRINT 

214  POKE 216,9: REM RESET ONERR 

216 ONERR GOTO 214 

218 HOME : PRINT "YOU MAY CHOOSE 


FROM THE FOLLOWING -": PRINT 

220 PRINT " <L> LOAD FROM CASSE 
TTE" 

222 PRINT " <S> SAVE TO CASSETT 
E" 

224 PRINT " <?> CATALOG DISKETT 
E" 

226 PRINT " <R> RUN APPLE WRITE 
R” 


228 PRINT "<ESC> QUIT": PRINT 


(Continued) 


APPLE TECH NOTES Copyright (C) 1982 by Apple Computer, Inc. 


a— —-—— A ren. Er Tr c € um m u cw m dam dum adhe Cm mp a Rs m us a dn k a dae cy m aw mr mr cus cum m cum mw ra m vr, œ m up c aum r r AR m m um cum AK cq oq E pi n cim, cnm nnns umm its MÓN MI 


-b air —o— a— — ee ce ——Á —— n "— —À— — X — i a — -m — ——À a— ee —À MÀ m —— -— — —— "-— — A—X A et — — — — — — ee E E —Á—— GEHEN — ——— — — — — — — — — — 


230 HTAB 1: PRINT "SELECT: “3: GET 
WS 
232 IF WS = "L" THEN PRINT "LOA 
D": GOTO 600 
234 IF WS = "S" THEN PRINT “SAV 
E": GOTO 39% 
236 IF WS = "?" THEN PRINT "CAT 
ALOG": PRINT DS;" CATALOG": PRINT 
HTAB 7: PRINT "PRESS ANY K 
EY TO CONTINUE ";: GET W$: GOTO 
214 
238 IF WS = "R" THEN PRINT "RUN 
APPLE WRITER": PRINT D$;"VE 
RIFY TEDITOR": TEXT : VTAB 2 
Ø: PRINT DS;" BRUN TEDITOR" 
IF WS = CHRS (27) THEN 869 
GOTO 23% 
REM 
GET FLLE TO RECORD 


Woh fo 
p 


a e 
UVP TV 


302 GOSUB 790: REM GET FILENAME 

304 PRINT DS;"BLOAD “¿NS 

306 FLASH : HTAB 12: PRINT " MEA 
SURING FILE ": NORMAL 

308 AD = 6400: REM BEGINNING 

310 IF PEEK (AD) < > 96 THEN A 
D = AD + 1: GOTO 319 

312 L » AD - 6399: REM LENGTH 

ADA REM 
DECIMAL TO HEX CONVERTER 


402 HXS = "0123456789ABCDEF" 
404 P = 3: REM POWER OF 16 
406 FOR X = 1 TO 4 

408 H1Z(X) = AD / 16 ^ P 


416 IF H1%(X) > O THEN AD = AD - 
(H1%(X) * 16 ^ P) 

412 P = P - 1: NEXT X 

414 FOR X = 1 TO 4:H1S(X) = MIDS 


(HXS,(HL%Z(X) + 1),1): NEXT X 
416 H2$ = H1S(l) + H15(2) + H15(3 
) + H15(4) 
500 REM 
WRITE FILE TO CASSETTE 


502 PRINT DS;"OPEN WRITER" 
504 PRINT D$; WRITE WRITER" 
506 PRINT “199@0.";H2$;"W" 
508 PRINT "3DQG" 

519 PRINT "GOTO 53$" 


(Continued) 
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512 PRINT D$;"CLOSE WRITER" 

514 HOME : PRINT "MAKE A NOTE OF 
THIS INFORMATION." 

516 PRINT "IT WILL BE NEEDED TO 
RELOAD FILE." 

518 PRINT : PRINT "--> NAME: ";N 
$: PRINT "--» MEASUREMENT: 1 
900." :H2S8: PRINT "--> LENGTH 
€ She. PRINT 

520 PRINT "START CASSETTE IN ";: 

INVERSE : PRINT "RECORD";:: 
NORMAL : PRINT " MODE"; BELS 
: PRINT 

522  HTAB 1: PRINT "PRESS «RETURN 
> WHEN READY";: GET CR$ 

524 IF CRS < > CHRS (13) THEN 
522 

>26 PRINT DS;" EXEC WRITER" 

528 CALL - 151 

530 INPUT "";DUMMYS: HOME 

232 PRINT DS; DELETE WRITER” 

534 GOTO 214 

690 REM 

READ FILE FROM CASSETTE 


602  GOSUB 7090: REM GET FILENAME 

604 PRINT : INPUT "MEASUREMENT: 
1900." :H2$ 

606 PRINT : INPUT "LENGTH: ";L 

608 PRINT D$; "OPEN READER" 

619 PRINT D$;"WRITE READER" 

612 PRINT "1999.";H2S;"R" 

614 PRINT "“3DAPG" 

616 PRINT “GOTO 639" 

618 PRINT D$;"CLOSE READER" 

620 HOME : PRINT "START CASSETTE 

IN ";: INVERSE : PRINT "PLA 

Y";: NORMAL : PRINT " MODE”; 
BEL$: PRINT 

622 HTAB 1: PRINT "PRESS «RETURN 
> WHEN READY";: GET CRS 

624 IF CRS < > CHRS (13) THEN 

622 

626 PRINT D$;"EXEC READER” 

628 CALL - 151 

630 INPUT "";DUMMY$: HOME 

632 PRINT DS;"DELETE READER” 

634 PRINT DS;“BSAVE “;NS;", A64@ 
Us. Lb 


( Continued) 
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Page 2500.011.04 Apple Writer 
636 GOTO 214 
700 REM 
GET FILENAME 

702 NOS = "TEXT." 

704 PRINT 

706 HTAB l: CALL - 958: PRINT ^ 
FILENAME: ";N0$;: GET NIS 

708 IF NIS = "?" THEN HTAB 11: PRINT 
"CATALOG": PRINT D$; "CATALOG 
"+ PRINT : HTAB 7: PRINT "PR 
ESS ANY KEY TO CONTINUE ";: GET 
WS: POP : GOTO 214 

710 IF NIS = CHRS (8) THEN NOS = 
"": GOTO 796 

712 IF NLS = CHRS (27) THEN 890 

714 PRINT NLS;: INPUT "";N$:NS$ = 
NØS + NIS + NS 

716 RETURN 

899 REM 

END 
802 PRINT DS;" NOMON C,I,0° 
894 TEXT : HOME : END 
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SENDING AN ESCAPE CHARACTER TO A PRINTER 


Apple Writer ][ will allow embedding of control characters in the text of a 
document with the control-V option. However it isn't obvious how to insert 
the escape character into the text. The first time escape is pressed after 
a control-V the cursor will change to the "^" character, indicating that 
the next character will be capitalized. Press the escape key again and an 


inverse "[" character will be displayed and the cursor will move to the 
right. The "[" is the escape character. 
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PRINTING WITH PARALLEL PRINTERS 


Apple Writer Version 2.9 may not work properly with some parallel interface 

cards. Often the interface requires a Control-I sequence if it is to print 

wider than 44 columns. This is easy in Apple Writer ][. All you need to do 
is insert the 


<Control-V><Control-I><Control-V> 132N 
at the start of each file. You will have to use the control-V before and 


after the control-I to enter it into the file. Please refer to page 5l of 
the Apple Writer manual for more details. 
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LNIERING CONTROL CHARACTERS 


Apple Writer ][ allows entering control characters into a file with the 
control-V command. However, some control characters can't be entered, e.g. 
ASCII 22 (control-V), ASCII 31 (control-underline), and ASCII 128 (control-@ 
with high bit set). Here is an Applesoft program that will build a glossary 
file with the control characters you need. First boot DOS and enter 
Applesoft. Enter: 


1D DS = CHRS(4) 

20 PRINT DS;"OPEN GFILE” 

30 PRINT D$;" WRITE GFILE” 

40 PRINT “1";CHRS (31) : REM CONTROL-UNDERLINE 

59$ PRINT "2";CHRS (128) : REM CONTROL-@ WITH HIGH BIT SET 
60 PRINT "3";CHRS (22) : REM CONTROL-V 

70 PRINT D$; CLOSE GFILE" 

8% END 


Run this program, then boot Apple Writer ][. Type control-Q and select 
option 5. Insert the diskette that has GFILE and type GFILE, and press 
return. 


Now, when you want to insert an ASCII 31 in your text, type control-G l. 
You can also insert a control-V by typing Control-G 3. 
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SUP-R-TERM AND SUPER SERIAL CARD 


Apple Writer may not print with these cards unless you set the following 
switches on the Super Serial Card to: 


SW2-3 off 
SW2-4 off 


This sets the line width to 132 columns and disables the echo to the 
49 column Apple video output. 
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TOP LINE 


The TopLine command changes the default top line, but page L may still have 
a top line. The reason for this is that the default top line gets printed 
before Apple Writer starts reading text and has a chance to see any .TL 
commands. 


You must insure that the TL parameter in the print options menu is a blank 
line and that there isn^t a .TL command in your file to supress printing of 


a top line on page l. 


You can also use the default top line to print on page 1 and insert a 
.TL<CR> in the text to supress printing of the top line on subsequent 
pages. 


The TL command is described on page 66 of the Apple Writer /// manual. 
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CONVERTING MAIL LIST MANAGER FILES 


Mail List Manager doesn^t physically remove “deleted” records from the 
MLMDATA file. When the Apple Writer /// Utilities conversion program is 
used to convert the MLMDATA file to an Apple Writer /// file, those records 
at the end of MLMDATA, equal to the number of records deleted, are not 
converted. What you get in the Apple Writer /// file are the total number 
of records Mail List Manager knows about including deleted records and 
missing records equal to the number of records previously deleted. 


A way around the problem: 
When ready to convert to Apple Writer /// 


l. Merge Mailing List to another diskette (this will get 
rid of the deleted records). 


2. Convert to Apple Writer /// file with Apple Writer /// 
Utilities. 
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FOOTNOTES 


Footnotes longer than 132 characters will stop Apple Writer /// while 
printing with a WPL "FOOTNOTE OVERFLOW" error. There is no fix available at 
this time. 


When a footnote is inserted in the text, the character immediately 
following the note is omitted. Example: 


the text: 

....Apple User^s Groups (<See Answer Book 2.>)are a good.... 
how it printed: 

...-Apple User's Groups re a good.... 


This problem can be worked around by adding an extra space after the 
footnote. Example: 


....Apple User^s Groups (<See Answer Book 2.5) are a good.... 


Footnotes don^t obey the Right margin. There is no fix available at this 
time. 


Footnotes won’t be printed if there isn't enough text on the page. 
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AVAILABLE SPACE 


Apple Writer /// can edit files up to 65021 characters long at a time. 
This figure applies to both 128K and 256K Apple ///s. Please note that as 
the file gets larger, the computer takes longer to process the typed 


characters. It isn’t unusual for good typists to lose characters as the 
file grows. 
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NEC SPINWRITER 


The NEC 7710 and 5519 will do bold and shadow printing with the following 
command: 


<control-V><escape><escape><control-Vot+ 


Bold print mode will continue until the end of the line where the printer 
issues a carriage return. The command to cancel bold print mode before the 
end of the line is: 


<control-V><escape><escape><control-V>, 
Notice that the escape key must be pressed twice for the character to be 


entered into the file. An inverse "[" on the screen is the escape 
character. 
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UNDERLINING 


Whenever a word to be underlined is the first word in a new line and the 
previous line ends at the rightmost margin location, the backslash to start 
underlining is ignored and underlining begins at the next backslash that 
should mark the end of the underline. You can alter the text before the 
first backslash to prevent the previous line from ending on the right 
margin. 


There is a problem if the word to be underlined has a period or comma right 
after it. Since the backslash generates a space, you can't do this unless 
you incude the period in the word to be underlined, which of course 
underlines the period or comma also. 
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